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About this guide 



This guide provides information about: 

• Setting up and configuring the HP StorageWorks Multi-protocol (MP) Router 

• Maintaining and operating the MP Router 

• Basic troubleshooting and diagnostics 

Intended audience 

This guide is intended for system administrators and technicians who are experienced with the following: 

• HP StorageWorks Fibre Channel Storage Area Network (SAN) switches 

• XPath Operating System (OS) 7.4.x or earlier 

Related documentation 

Documentation, including white papers and best practices documents, is available on the HP 
web site: 

http:/ / www.hp.com/ country/ us/ eng/ prodserv/ storage.html 
To access current Fabric OS related documents: 

1 . Locate the IT storage products section of the web page. 

2. Under Networked storage, click the SAN Infrastructure subsection. 

3. From the SAN Infrastructure web page, locate the SAN Infrastucture products section. 

4. Click Multi-protocol Routers and Gateways. 

5. To access XPath OS 7.4.x documents (such as this document), click B-Series Multi-Protocol Router. 
The HP StorageWorks B-Series Multi-Protocol Router overview page displays. 

6. Go to the Product Information section, located on the right side of the web page. 

7. Click Technical documentation. 

8. Follow the onscreen instructions to download XPath OS 7.4.x documents. 
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Document conventions and symbols 



Table 1 Document conventions 



Convention 


Element 


Medium blue text: Figure 1 


Cross-reference links and e-mail addresses 


Medium blue, underlined text 

1 httn ■ / /www hn ("oml 

llllll^i/ / VVVVVVill)-^ • ^ W 1 1 1 I 


Web site addresses 


Bold font 


1 y II \ji 1 1 1 ^ o 

• Text typed into a GUI element, such as into a box 

• GUI elements that are clicked or selected, such as menu and 
list items, buttons, and check boxes 


Italics font 


Text emphasis 


Monospace font 


• File and directory names 

• System output 

• Code 

• Tpyt t\/npH nt thp rnmmnnn- inp 

1 ^y^i 1 y k^^v^ \ji 1 111^ ^ 1 1 1 1 1 iVhI i i \hI i i i i ^ 


Monospace, italic font 


• Code variables 

• Command-line variables 


Monospace, bold font 


Emphasis of file and directory names, system output, code, and 
text typed at the command line 



A WARNING! Indicates that failure to follow directions could result in bodily hiarm or death. 



A CAUTION: Indicates that failure to follow directions could result in damage to equipment or data. 



^ IMPORTANT: Provides clarifying information or specific instructions. 



NOTE: Provides additional information. 



Rack stability 



A WARNING! To reduce the risk of personal injury or damage to equipment: 

• Extend leveling jacks to the floor. 

• Ensure that the full weight of the rack rests on the leveling jacks. 

• Install stabilizing feet on the rack. 

• In multiple-rack installations, secure racks together. 

• Extend only one rack component at a time. Racks may become unstable if more than one component is 
extended. 
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HP technical support 

Telephone numbers for worldwide technical support are listed on the HP support web site: 
http:/ / www.hpxom/ support/ . 

Collect the following information before calling: 

• Technical support registration number (if applicable) 

• Product serial numbers 

• Product model names and numbers 

• Applicable error messages 

• Operating system type and revision level 

• Detailed, specific questions 

For continuous quality improvement, calls may be recorded or monitored. 

HP strongly recommends that customers sign up online using the Subscriber's choice web site: 
http:/ / www.hp.com/ go/ e-updates . 

• Subscribing to this service provides you with e-mail updates on the latest product enhancements, newest 
versions of drivers, and firmware documentation updates as well as instant access to numerous other 
product resources. 

• After signing up, you can quickly locate your products by selecting Business support and then Storage 
under Product Category. 

HP-authorized reseller 

For the name of your nearest HP-authorized reseller: 

• In the United States, call 1-800-282-6672. 

• Elsewhere, visit the HP web site: http:/ / www.hp.com . Then click Contact HP to find locations and 
telephone numbers. 

Helpful web sites 

For other product information, see the following HP web sites: 

• http://www.hp.com 

• http:/ / www.hp.com/ go/ storage 

• http://www.hp.com/support/ 

• http://www.docs.hp.com 
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1 XPath OS CLI commands 



This chapter lists the MP Router command line interface (CLI) commands in alphabetical order. It also 
shows their syntax and operands, and provides examples of their usage. 

You can access the same information for each command by using the help command on the MP Router. 
For example, to get information about the aliadd command, enter help aliadd at the command 
prompt, as follows: 

switch :adinin> help aliadd 
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agtCfgSet 

Configures Simple Network Management Protocol (SNMP) agent system parameters and 
trap recipient. 

Synopsis 

agtcf gset 

Availability 

admin 

Description 

Use this command to set the sysDescr, sysLocation, and sysContact parameters of the MIB-II 
system group. All these parameters accept letters, digits, spaces, underscores, hyphens, and percent and 
dollar signs, with a maximum length of 255 characters. 

This command also configures the sweventTrapLevel. Only events that have a severity of 
swEventTrapLevel or higher generate a trap. Possible levels include: 



0 


Panic 


1 


Critical 


2 


Error 


3 


Warning 


4 


Info 


5 


Debug 



This command allows a maximum of 10 trap recipients. Each trap recipient is composed of a community 
string and an IP address. The order of the trap recipients has no meaning; traps are sent to all configured 
recipients. The community string has the same syntax as other system parameters. 

Operands 

none 
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Examples 

In the following example, sysLocation is changed from End User Premise to Hardware Lab. The 
community string of the first trap recipient is changed from com23 to public , and the IP address of the 
second trap recipient is changed from 192 . 168 . 74 . 12 to 192 . 168 . 74 . 13: 

switch :admin> agtcfgset 

Customize MIB-II system variables 

At each prompt, do one of following: 

<return> to accept current value 
enter the appropriate new value 

<ctrl-D> to skip the rest of configuration and finish 
<ctrl-C> to cancel any changes 

sysDesc : [Silkworm Fibre Application Platform] 
sysLocation: [End User Premise] Hardware Lab 
sysContact: [Tech Support] 
swEventTrapLevel : (0..4) [3] 

SNMP community and trap recipient configuration: 
You can add maximum 10 trap recipients 
type <■> at IP address to delete the recipient 
recipientl--Community [com23] public 

recipientl--IP address in dot notion [192.158.74.12] 
rec ipient2 - -Communi ty [ contro_center ] 

recipient2--IP address in dot notion [192.168.74.11] 192.168.74.13 
recipient3--Community [unconfigured] 



See also 

agtCf gSliow 
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agtCfgShow 



Displays SNMP agent system parameters and trap recipient. 



Synopsis 



agtcf gshow 



Availability 

all users 



Description 

Use this command to display the sysDescr, sysLocation, and sysContact parameters of the MIB-I 
system group, swEventTrapLevel, and trap recipients: 



sysDescr 

sysLocation 

sysContact 

swEventTrapLevel 



Operands 

r 

Examples 



none 



System (router) description (in the MIB-II definition). The default value is 

MP_ROUTER. 

System location (in MIB-II). The default value is End User Premise. 

System contact information. The default is Tech Support. 

Event trap level in conjunction v/ith the event severity level. When an 
event occurs, if its severity level is at or below the set value, the SNMP 
trap, swEventTrap, is sent to the configured trap recipients. By default, 
this value is 3, v/hich means that any event that has a severity equal to or 
higher than "v/arning" causes an swEventTrap to be sent. Possible 
values include: 



panic 

critical 

error 

warning 

informational 

debug 



To display the SNMP agent system parameters and trap recipient: 



switch : admin> agtcfgshow 

Current SNMP Agent Configuration 
Customizable MIB-II system variables: 
sysDescr = MP_ROUTER 
sysLocation = End User Premise 
sysContact = Tech Support 
SwEventTrapLevel = 3 



SNMPv2 Trap Recipient Configuration 
recipientl--Community=com2 3 
recipientl--IP address=192 . 168 . 74 . 12 

recipient2 --CommunitY=control_centerl 
recipient2--IP address=192 . 168 .74.11 

recipients --Community=control_center 2 
recipients --IP address=192 .168.74.20 



See also 



agtCfgSet 
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aliAdd 

Adds a member to an alias. 



Synopsis 

aliadd "aliName", " aliMemberhist" 

Availability 

admin 



Description 

Use this command to add one or more members to an existing alias, aliName. The aliMemberhist 
option is one or more semicolon-separated world wide names (WWNs), and domain,port pairs, or iSCSI 
qualified names (IQNs). 

For a description of members, see aliCreate. 



f^>f NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cf gEnable command. 

For the change to be preserved across MP Router reboots, save the change to nonvolatile memory using 
the cfgSave command. 



Operands 

The following operands are required: 

"aliName" A name for the alias, in quotation marks. 

"aliMemberhist" A semicolon-separated list of members, in quotation marks. 

Examples 

To add disk arrays to ALIAS_1 : 



switch :adinin> aliadd "ALIAS_1", " 2 0 : 00 : 00 : eO : 8b : 01 : 8f : 85 ; 20,5" 



See also 

aliCreate 
aliDelete 
aliRemove 
aliShow 
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aliCreate 

Creates an alias. 

Synopsis 



alicreate " aliName", "aliMemberhist'' 



Availability 

admin 



Description 

Use this command to create a new alias, aliName, which must be unique among all other alias or zone 
object names. The aliMemberhist operand is one or more semicolon-separated WWNs, domain, port 
pairs, or iSCSI qualified names (IQNs). 

An alias name is one letter followed by any combination and number of letters, digits, and underscore 
characters. Names are case sensitive: for example, Alias_l and alias_l are different aliases. Spaces are 
ignored. 

The zone alias member list must have at least one member. Each member is described by a 
semicolon-separated list of member definitions. The alias member list cannot contain another zone alias. 

\A/WNs are specified as eight hexadecimal numbers separated by colons, for example, 
10:00:00:60:69:00:00: 8a. Zoning has no knowledge of the fields within a WWN: The 8 bytes are 
simply compared with the node and port names presented by a device in a login frame— fabric login 
(FLOG!) or port login (PLOGI). When an alias member is specified by node name, all ports on that device 
are in the zone. When an alias member is specified by port name, only that single device port is in the 
zone. 

Physical fabric port numbers can also be specified as a pair of decimal numbers, d,p, where d is the MP 
Router number (domain ID) and p is the port number on that MP Router. For example, "6 , 10" specifies 
port 1 0 on MP Router number 6. When an alias member is specified by physical fabric port number, then 
all devices connected to that port are in the zone. No spaces are allowed. 

iSCSI qualified names (IQNs) are specified as ic^n. .year-month .unique_iSCSl_domain_lD; for 
example: 

iqn .1991-05. com. microsoft: rst-win2k-pcl2 
iqn. 2 002-12 . com. hp : 22 000004ef d712ea 



NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cfgEnable command. 

For the change to be preserved across MP Router reboots, save to nonvolatile memory using the cf gSave 
command. 




Operands 

The following operands are required: 

"aliName" A name for the alias, in quotation marks. 

"aliMemberhist" A semicolon-separated list of members, in quotation marks. 
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Examples 

To create two aliases, ALIAS_1 and ALIAS_2: 



switch: 


: adinin> 


alicreate 


"ALIAS_1 " , 


"21:00:00 


: 20 ; 


:37:65:ec:43; 20,3" 


switch; 


: adinin> 


alicreate 


"ALIAS_2 " , 


"iqn.2001- 


-04 , 


. com . example : arraysaS 6 " 



See also 

aliAdd 
aliDelete 
aliRemove 
aliShow 
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aliDelete 

Deletes an alias. 

Synopsis 

alidelete " aliName" 

Availability 

admin 

Description 

Use this command to delete alias aliName. 



"2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cfgEnable command. 

For the change to be preserved across MP Router reboots, save to nonvolatile memory using the cf gSave 
command. 



Operands 

The follov/ing operand is required: 

"aliName" A name for the alias, in quotation marks. 

Examples 

To delete the alias ALIAS_1 : 

switch : admin> alidelete "alias_i" 

See also 

all Add 
aliCreate 
allRemove 
aliShow 
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aliRemove 



Removes a member from an alias. 



Synopsis 

aliremove " aliName", " aliMemberList" 

Availability 

admin 

Description 

Use this command to remove one or more members from an existing alias. 
For the description of members, see the aliCreate help. 

r2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 

li— I effective, you must enable an appropriate zone configuration using the cfgEnable command. 




For the change to be preserved across MP Router reboots, save to nonvolatile memory using the 
cfgSave command. 



Operands 



The following operands are required: 



a J iMemberLi s t 



aliName 



The name of an existing alias, in quotation marks. 

A semicolon-separated list of members (one or more world wide 
names [WWNs], domain,port pairs, or IQNs), in quotation 
marks. 



Examples 



To remove 20:00:00:eO:8b:01 :8f:85 and 20,5 from ALIAS_1: 



switch : adinin> aliremove "ALIAS_1 



20:00:00:e0:8b:01:8f :85; 20,5 



See also 



aliAdd 



aliCreate 



aliDelete 



aliShow 
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aliShow 

Displays zone information. 

Synopsis 

alishow [-i] ["pattern" ] 

Availability 

all users 

Description 

Use this command with no parameters to display all zone configuration information (both defined and 
effective configurations). 

If a parameter is specified, it is used as a pattern to match alias names, and those that match in the 
defined configuration are displayed. 

Patterns might contain the following: 

• Question mark (?), which matches any single character. 

• Asterisk (*), which matches any string of characters. 

• Characters [0-9, a-z, A-Z,_], which match the character. 
See cf gShow for a description of this display. 

Operands 

The following operands are optional: 

"pattern" Can contain any of the valid characters mentioned 

-i Displays iSCSI qualified names (IQNs) instead of World Wide 

Names (WWNs) 

Examples 

To display zone information: 



switch 


admin> 


alishow -i 


"ALI* " 


alias : 


ALIAS, 


_1 








21:00:00: 


e0:8b:02:38:d2 






20,4 




alias : 


ALIAS, 


_2 








iqn.2001- 


04 . com. example : arraysa86 



See also 

all Add 

aliCreate 

allDelete 

allRemove 

cf gShow 

zoneShow 
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altBoot 

Boots the switch to the other flash image. 

Synopsis 

altboot 

Availability 

admin 

Description 

Use this command to boot the switch to the inactive bank. 



'2^^ NOTE: The command does not boot the switch if there is no XPath OS present in the inactive bank. 
When a firmware commit for the bank is scheduled, the command prompts the administrator for 
confirmation of a f irmwareCoinmit of the inactive bank before booting the switch. 



Operands 

none 

Examples 

To boot to the inactive bank: 

switch ; admin> altboot 

See also 

f irmwareCommit 
f irmwareDownload 
f irmwareShow 
version 
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bannerSet 

Sets the security banner on the MP Router. 

Synopsis 

bannerset [banner] 

Availability 

admin 

Description 

Use this command to set the security banner on the MP Router. 

The security banner is a string of alphanumeric characters that is displayed whenever a user tries to log in 
to an MP Router. 

Create the banner by using the jbanner operand or enter bannerSet without an operand for an 
interactive session. 

To close the banner text string, enter a period at the beginning of a new line. 
Operands 

This command has the following optional operand: 

banner Specifies a text string to display when users log in. The security 

banner must be between 1 and 1 16 characters or 1022 
characters in interactive mode. 

If the banner text length exceeds the maximum allowed with 
multiple lines of input, the software truncates the input. If the 
banner text length exceeds the maximum allowed with a single 
line of input, the software stops accepting characters. 

Examples 

To set the banner to "My platform": 

switch : admin> bannerset "My platform" 



To set the banner to "My platform" in interactive mode: 



switch : admin> bannerset 








Please input context of security 


banner 


(press " 


" RETURN 


at the beginning of a newline to 


finish 


input) : 




My platform 









See also 

bannerShow 
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bannerShow 

Displays the security banner on the local MP Router. 

Synopsis 

bannershow 

Availability 

all users 

Description 

Use this command to display the security banner on the local MP Router. 

Operands 

none 

Examples 

To display the banner on the local MP Router: 

switch : ad[nin> bannershow 
My platform. 

See also 

bannerSet 
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beacon 

Blinks the system LED on the MP Router. 

Synopsis 

beacon [on | off] 

Availability 

admin 

Description 

Use this command to blink the system LED on the MP Router, which makes it easier for administrators to 
identify a particular MP Router in their data centers. The LED alternately blinks green and amber for a 
second. 



r2^^ NOTE: If an MP Router is disabled and then enabled while beaconing, the MP Router LED no 
li— I longer blinks. 



Operands 

This command has the following optional operands: 

on Turns the beacon on. 

off Turns the beacon off. 

Examples 

To turn the beacon on: 

switch : admin> beacon on 
To turn the beacon off: 

switch : admin> beacon off 

See also 

switchShow 
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burninErrShow 

Displays errors stored in the nonvolatile memory on the MP Router during burn-in. 

Synopsis 

burninerrshow 

Availability 

admin 

Description 

Use this command to display errors stored in nonvolatile memory on the MP Router during burn-in. 

Operands 

none 

Examples 

To display burn-in errors: 

switch : adinin> burninerrshow 

See also 

diagSetBurnin 
diagStopBurnin 
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burninStatus 

Displays burn-in status. 

Synopsis 

burninstatus 

Availability 

admin 

Description 

Use this command to display the burn-in status of the system. The output contains the state, status, current 
run number, current command in the run, total commands in the run, and the burn-in script name. 

Operands 

none 

Examples 

To display the burn-in status: 



switch 


admin> burninstatus 








State 


Status Run 


Cmd 


TotCmds 


Script 


ABORT 


PASS 3 


18 


41 


switchess . sh 



See also 

diagSetBurnin 
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celloPortTest 



Performs a functional test of the MP Router fabric ASIC. 

Synopsis 

celloporttest [-t port_list] [-r port_list] [-n count] 
[-1 length] [-c chk_content] 

Availability 

admin 

Description 

Use this command to test the connection between the port ASICs and the switching ASICs. 

All ports involved in the test must be diagnostics-enabled (using portDiagEnable) prior to running this 
test. 

Because the bridge port (an internal port) cannot be changed to diagnostics mode during normal 
operation, it can be tested only in the power-on self test (POST) environment. 

This test can verify all the possible links if the source ports and destination ports include all user ports and 
bridge ports. 

Operands 

This command has the following optional operands: 

-t port_list Specifies a list of source ports. The default value is all ports. 

-r port_list Specifies a list of destination ports. The default value is all ports. 

-n count Specifies the number of frames to send to each destination. The 

default value is 100. 

-1 length Specifies the payload length of the test frames. The default value 

is 2048. 

-c chk_content Verifies frame content at the destination ports. This feature is 

disabled by default. A value of 1 specifies check contents; 0 
specifies do not check contents. 

Examples 

To transmit 2048-bytes frames from ports 1 and 2 to ports 3 and 5, use the following command: 

switch: admin> celloporttest -t 1,2 -r 3,5 

Port Tx fr Tx bytes Rx fr Rx bytes Bad fr Order fr Error RSLT 



0001 00000200 000000413500 00000000 000000000000 00000000 00000000 00000 PASS 

0002 00000200 000000413600 00000000 000000000000 00000000 00000000 00000 PASS 

0003 00000000 000000000000 00000200 000000413600 00000000 00000000 00000 PASS 
0005 00000000 000000000000 00000200 000000413600 00000000 00000000 00000 PASS 
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See also 

crossPortTest 
portDiagDi sable 
portDiagEnable 
portLoopbackTest 
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cfgActvShow 

Displays effective zone configuration information. 

Synopsis 

cfgactvshow [-i] 

Availability 

all users 

Description 

Use this command to display the effective zone configuration information. 

The effective configuration is a single zone configuration that is currently in effect. The devices that an 
initiator sees are based on this configuration. The effective configuration is built when a specified zone 
configuration is enabled. 

If the -i option is used, the iSCSI qualified name (IQN) is displayed; otherv/ise, WWN format is 
displayed for iSCSI members. 

Operands 

The following operand is optional: 

-i Displays the IQN. 

Examples 

To display the effective zone configuration information: 



switch : adinin> cfgactvshow 




Effective configuration: 




Cfg: USA_cfg 




Zone : ZONE_A 




21:01:00:e0: 


8b:22 :a2 :38 


20,4 




Zone : ZONE_B 




21:00:00:20: 


37:c8:97:04 


iqn. 2001-04 


. com . example : arraysaSe 



See also 

cf gShow 
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cfgAdd 

Adds a new member to a zone configuration. 

Synopsis 

cfgadd " cfgName", " cfgMemberList" 

Availability 

admin 

Description 

Use this command to add one or more members to an existing zone configuration, cfgName. The 
cfgMemberList operand is a semicolon-separated list of one or more zone names. 



p2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cf gEnable command. 

For the change to be preserved across MP Router reboots, save it to nonvolatile memory using the 
cfgSave command. 



Operands 

The follov/ing operands are required: 

"cfgName" A name for the zone configuration, in quotation marks. 

"cfgMemberList" A semicolon-separated list of members, in quotation marks. 

Examples 

To add a nev/ zone to the configuration USA cfg: 

switch: admin> cfgadd "USA_cfg" , "ZONE_C" 

See also 

cf gClear 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cf gShow 
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cfgClear 

Clears all defined zone configurations. 

Synopsis 

cf gclear 

Availability 

admin 

Description 

Use tfiis command to clear all defined zone information from the fabric. Disable all zone configurations 
before running the command. After clearing the defined zone information, use the cf gDisable 
command to disable and clear the zone configuration in nonvolatile memory for all the switches in the 
fabric. 

Operands 

none 

Examples 

To clear all zones and nonvolatile memory: 

switch : adinin> cf gclear 
switch :adinin> cfgdisable 

See also 

cf gDisable 
cf gEnable 
cf gSave 
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cfgCreate 

Creates a zone configuration. 



Synopsis 

cfgcreate " cfgName", " cfgMemberList" 

Availability 

admin 



Description 

Use this command to create a new zone configuration, cfgName, which cannot be used for any other 
zone object. cfgMemberList is a semicolon-separated list of one or more zone names. 

A zone configuration name is a letter followed by any number of letters, digits, and underscores. Names 
are case sensitive; for example, Cf g_l and cf g_l are different zone configurations. Spaces are ignored. 

The zone configuration member list, cfgMemberList, has at least one member (empty lists are not 
allowed). 



p2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cfgEnable command. 

For the change to be preserved across MP Router reboots, save it to nonvolatile memory using the 
cfgSave command. 



Operands 

The following operands are required: 

"cfgName" A name for the zone configuration, in quotation marks. 

"cfgMemberList" A semicolon-separated list of members, in quotation marks. 

Examples 

To create a configuration containing two zones, ZONE_A and ZONE_B: 

switch: admin> cfgcreate "USA_cfg" , " ZONE_A; ZONE_B" 

See also 

cfgAdd 
cf gClear 
cf gDelete 
cf gDisable 
cfgEnable 
cf gRemove 
cf gSave 
cf gShow 
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cfg Delete 

Deletes a zone configuration. 

Synopsis 

cfgdelete " cfgName" 

Availability 

admin 

Description 

Use this command to delete a zone configuration, cfgName. 



NOTE: Tfiis command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cfgEnable command. 

For the change to be preserved across MP Router reboots, save it to nonvolatile memory using the 
cfgSave command. 



Operands 

The follov/ing operand is required: 

"cfgName" A name for the zone configuration, in quotation marks. 

Examples 

To delete the zone configuration USA cfg: 

switch :adinin> cfgdelete "USA_cfg" 

See also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDisable 
cfgEnable 
cf gRemove 
cf gSave 
cf gShow 
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cfgDisable 

Disables a zone configuration. 

Synopsis 

cf gdisable 

Availability 

admin 

Description 

Use this command to disable the current zone configuration. The fabric returns to nonzoning mode, in 
which all devices are known to each other. 

Operands 

none 

Examples 

To disable the enabled zone configuration: 

switch : admin> cf gdisable 
Cfg Disable Successful 

See also 

cf gClear 
cf gEnable 
cf gSave 
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cfg Enable 

Enables a zone configuration. 

Synopsis 

cfgenable "cfgName" 

Availability 

admin 

Description 

Use this command to commit any defined zone configuration to both volatile and nonvolatile memory and 
to enable the specified zone configuration. 

The specified zone configuration is built by checking for undefined zone names, zone alias names, or 
other inconsistencies and by expanding zone aliases, removing duplicate entries, and installing the 
effective configuration. 

If the build fails, the previous state is preserved (zoning remains disabled, or the previous effective 
configuration remains in effect). If the build succeeds, the nev/ configuration replaces the previous 
configuration. 

See the cfgShow command for a description of defined and effective configurations. 

Operands 

The follov/ing operand is required: 

"cfgName" A name for the zone configuration, in quotation marks. 

Examples 

To enable zone configuration USA_cfg: 

switch ; adinin> cfgenable "USA_cfg" 

See also 

cf gClear 
cf gDisable 
cf gSave 
cf gShow 
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cfg Remove 

Removes a member from a zone configuration. 



Synopsis 

cfgremove " cfgName", " cfgMemberList" 

Availability 

admin 



Description 

Use this command to remove one or more members from an existing zone configuration, cfgName. 
cfgMemberList is a semicolon-separated list of one or more zone names. If all members are removed, 
the zone configuration is deleted. 



["2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cfgEnable command. 

For the change to be preserved across MP Router reboots, save it to nonvolatile memory using the 
cfgSave command. 



Operands 

The follov/ing operands are required: 

"cfgName" A name for the zone configuration, in quotation marks. 

"cfgMemberList" A semicolon-separated list of members, in quotation marks. 

Examples 

To remove ZONE_C from zone configuration USA_cfg: 

switch : admin> cfgremove "USA_cfg", "ZONE_C" 



See also 

cfgEnable 
cf gSave 
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cfgSave 

Saves zoning configurations to nonvolatile memory. 

Synopsis 

cf gsave 

Availability 

admin 

Description 

Use this command to save the current zone configuration. The defined configuration and the name of the 
effective configuration are written to nonvolatile memory in all MP Routers in the fabric. 

This saved configuration is automatically reloaded by the MP Router on power-up; if a configuration was 
in effect when it was saved, the same configuration is reinstalled after power-up. 

Operands 

none 

Examples 

To save the current zone configuration: 

switch : adinin> cf gsave 

See also 

cf gClear 
cf gDisable 
cf gSave 
cf gShow 
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cfgShow 

Displays zone configuration information. 

Synopsis 

cfgshow [pattern] [-i] 

Availability 

all users 

Description 

Use this command without parameters to display all zone configuration information (both defined and 
effective configurations). 

The defined configuration displays the complete set of all zone objects that have been defined in the 
fabric. Multiple zone configurations might be defined (although only one can be in effect at a time). The 
defined configuration is the current state of the administrator's input. 

The effective configuration is a single zone configuration that is currently in effect. The devices that an 
initiator sees are based on this configuration. The effective configuration is built when a specified zone 
configuration is enabled. 

If an operand is specified, it is used as a pattern to match configuration names, and those that match in 
the defined configuration are displayed. 

Operands 

The following operands are optional: 

pattern May contain any valid character. Patterns might contain: 

• Question mark (?), which matches any single character. 

• Asterisk (*), which matches any string of characters. 

• Characters [0-9, a-z, A-Z,_], which match the character, 
-i Displays the information with the iSCSI name. 
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Examples 

To display all zone configuration information with the iSCSI name: 



switch : ad[nin> cfgshow -i 








Defined configurations: 








Cfg: USA_cfg ZONE_A; ZONE, 


_B 






Zone: ZONE A 

21:01:00 
20,4 


: eO ; 


: 8b:22 :a2 :38 




Zone : ZONE_B 








21 : 00:00 


:20: 


:37:c8:97:04 




iqn.2001- 


-04, 


. com. example ; 


: arraysa86 


Effective configuration: 








Cfg: USA_cfg 








Zone : ZONE_A 








21 : 01:00 


: eO : 


: 8b:22 :a2 :38 




20,4 








Zone : ZONE_B 








21 : 00:00 


:20: 


:37:c8:97:04 




iqn.2001- 


-04, 


. com. example : 


: arraysa86 



See also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
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cfgSize 

Displays size details for the zone database. 

Synopsis 

cf gsize 

Availability 

all users 

Description 

Use this command to display the size details for the zone database. 

The size details include the following (all sizes are in bytes): 

Zone DB max size The upper limit for the defined configuration. 

Current DB size The size of the defined configuration. 

A defined configuration might not be a committed 
configuration; for example, if a configuration is modified by a 
management interface, such as Telnet or API, and not yet 
committed (using the cfgEnable, cfgDisable, or 
cfgSave commands), it is defined but not committed. 
Therefore, the current zone database size might include 
uncommitted configurations. 

See cf gShow for a description of defined and effective configurations. 

Operands 

none 

Examples 

To display size details for the defined configuration: 



switch : admin> cfgsize 




Zone DB max size - 


130956 bytes 


Current DB size - 


372 4 bytes 



See also 

cf gShow 



40 XPath OS CLI commands 



chassisShow 

Displays chassis information. 

Synopsis 

chassisshow 

Availability 

all users 

Description 

Use this command to display general chassis-level hardware status information and configuration. The 
domain ID is either an unconfigured default value of 1 00 or a specific configured value. In the former 
case, the MP Router runtime domain ID can be changed by the fabric. 

Operands 

none 

Examples 

To display chassis information: 

switch : admin> chassisshow 

Chassis WWN=10 :00:EC:60:00:00:01:00 
Chassis TYpe=AP742 0 
Chassis Admin status=enabled 

Number of power supplies: 2 
POWER SUPPLY 1 status is OK 
POWER SUPPLY 3 Status is NOT PRESENT 



Number 


of fans: 


6 


Fan 


1 


status 


is 


OK 


Fan 


2 


status 


is 


OK 


Fan 


3 


status 


is 


OK 


Fan 


4 


status 


is 


OK 


Fan 


5 


status 


is 


OK 


Fan 


6 


status 


is 


OK 



ID: 456-777888 
Part Num: 23 0-290-12370 

Serial Num: 3456789 
Revision Num: A. 02 

See also 

f anShow 

psShow 

switchShow 



Domain Id=100 

Chassis Serial No. =0000234 
Chassis Part No.=0000A300 
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clear 

Clears the MP Router screen. 

Synopsis 

clear 

Availability 

all users 

Description 

Use this command to clear the MP Router screen. 

Operands 

none 

Examples 

To clear the MP Router screen: 

switch : admin> clear 

See also 

none 
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configDefault 



Sets system parameters to factory defaults. 



Synopsis 

conf igdef ault 

Availability 

admin 

Description 

Use this command to set all system parameters, except the following, to their factory defaults: 
Ethernet MAC address 
IP address of the management interfaces 
Subnet mask of the management interfaces 
IP gateway address of the management interfaces 
License keys 

World wide names (WWNs) 
Zoning configuration 
User accounts and passwords 
SNMP configurations 

Because some configurations are cached by the system, a reboot is forced after this command. 

Operands 



none 



Examples 



To set system parameters to their defaults: 



switch : adinin> conf igdef ault 

conf igdef ault requires a switch reboot, do you want to proceed? (y, n) y 
Configuration restored to factory default 
<switch then enters into reboot stage > 



See also 



conf igDownload 
conf igUpload 
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config Down load 



Restores the MP Router configuration from a host file. 

Synopsis 

conf igdownload -h hostName -f fileName [-u userName] [-p password] 
[-t fileTransferProtocol] [-1] 

Availability 

admin 

Description 

Use this command to download the configuration file from a specified FTP or Trivial File Transfer Protocol 
(TFTP) server. The default FTP account is used if either the user name or password is not specified. The 
default file transfer protocol is FTP. 

You must disable the MP Router before this operation. The IP configuration of the management interface is 
not immediately changed by this command. The configuration change takes effect at the next reboot. 

The conf igDownload command might fail for the following reasons: 

• The host is not known to the MP Router. 

• The host cannot be reached by the MP Router. 

• The user does not have permission on the host. 

• The FTP server is not running on the host. 

Operands 

The operands hostName and fileName are required: 

-h hostname Specifies the host name of an FTP or a TFTP server, 
-f filename Specifies the source file name. 

The following operands are optional: 

-u userName Specifies the user name for the FTP server, 

-p password Specifies the password for the user account, 

-t fileTransferProtocol Specifies the file transfer protocol. 
-1 Displays the current download configuration. 

Examples 

To download configuration file /misc/conf ig . txt (if /misc is available) from 10.7.32.168: 

switch : admin> conf igdownload -h 10.7.32.168 -f /misc/conf ig . txt -u root 
-p password -t ftp 

To download the configuration in misc/conf ig . txt (in this example, misc is in the guest home 
directory) from 10.7.32.168: 

switch : admin> conf igdownload -h 10.7.32.168 -f misc/conf ig . txt -u guest 
-p guest 

See also 

conf igUpload 
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configShow 



Displays current fabric-related MP Router parameters. 



Synopsis 

configshow [route] 

Availability 

all users 

Description 

Use this command to display current fabric-related MP Router parameters, which can be set through the 
configure command. In addition, the configshow command displays static Fibre Channel Shortest 
Path First (FSPF) routes. Route display format includes: 

route . ucastRoute . Count : route_count 
route . ucastRoute . port . domainid : exi t _jport 



Operands 



Examples 



The following operand is optional: 
route Displays only FSPF routes. 

To display current fabric-related MP Router parameters: 

switch : adinin> configshow 



fabric 


ops 


domain : 


100 ( 


fabric 


ops 


BBCredit : 


16 


fabric 


ops 


R_A_TOV : 


10000 


fabric 


ops 


E_D_TOV : 


2000 


fabric 


ops 


dataFieldSize : 


2112 


fabric 


ops 


mode . pidFormat : 


1 


fabric 


ops 


WA]SI_TOV : 


0 


fabric 


ops 


MAX_HOP_COUNT : 


7 


switch 


rscn_mode : 


1 



Static route: 



In-Port 



Domain 



Out-Port 



route .ucastRoute . Count : 0 



See also 



configDe fault 
configure 
switchDi sable 
switchEnable 
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config Upload 

Backs up the MP Router configuration to a host file. 

Synopsis 

configupload [-h hostName] [-f destinationFileName] [-u userName] 
[-p password] [-t fileTransferProtocol] [-1] 

Availability 

admin 

Description 

Use this command to upload the configuration file to a specified FTP or TFTP server. The default FTP 
account is used if either the user name or password are not specified. The default file transfer protocol 
is FTP. 

The conf igUpload command might fail for the following reasons: 

• The host is not known to the MP Router. 

• The host cannot be reached by the MP Router. 

• The user does not have permission on the host. 

• The FTP server is not running on the host. 

Operands 

The following operands are optional: 



-h 


hostname 


Specifies the host name of an FTP server. 


-f 


destinationFileName 


Specifies the destination file name. 


-u 


userName 


Specifies the user name for the FTP server. 


-P 


password 


Specifies the password for the user account. 


-t 


fileTransferProtocol 


Specifies the file transfer protocol. 


-1 




Displays the current upload configuration. 



Examples 

To upload the configuration file to /misc/conf ig . txt (if /misc is available) to 10.7.32.168: 



appdir : admin> configupload -h 10.7.32.16 


3 -f 


/misc/conf ig . txt -t ftp 


To upload the configuration file to misc/conf ig . txt 


in th 


's example, misc is in the guest home 


directory) to 10.7.32.168: 




appdir : admin> configupload -h 10.7.32.168 


! -f 


misc/conf ig . txt -u guest -p guest 



See also 

conf igDownload 
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configure 



Sets fabric-related MP Router configuration parameters. 



Synopsis 



configure 



Availability 

admin 



Description 

Use this command to interactively set the following fabric-related MP Router configuration parameters: 



Domain 



BB Credit 



R_A_TOV 



E_D_TOV 



Data Field Size 



Port ID Format 



WAN_TOV 



MAX HOP COUNT 



The domain number uniquely identifies the MP Router in a fabric. 
This value is automatically assigned by the fabric if it is not 
configured by the user. 

The buffer-to-buffer (BB) credit represents the number of 
frame-receipt buffers available to attached devices. The range of 
allov/ed values varies, depending on other system settings. 

The resource allocation timeout value (R_A_TOV) is displayed in 
milliseconds. This variable works with the variable e_d_tov to 
determine the actions of the MP Router when the next error 
condition occurs. 

Allocated circuit resources with detected errors are not released 
until the time value has expired. If the condition is resolved prior 
to the timeout, the internal timeout clock resets and waits for the 
next error condition. 

Error detect timeout value (E D TOV) is displayed in 
milliseconds. This timer flags a potential error condition when an 
expected response is not received (an acknowledgement or reply 
in response to packet receipt, for example) within the set time 
limit. 

This specifies the largest possible value, in bytes, for the data 
frame size. The MP Router advertises this value to other MP 
Routers in the fabric during construction of the fabric as well as to 
other devices when they connect to the fabric. Setting this to a 
value smaller than 21 12 can result in decreased performance. 

This specifies the port ID format: 

1 Core switch ID format 

2 Extended edge port ID format 

Wide area network timeout value (WAN_TOV) is displayed in 
milliseconds. This timer is the maximum frame timeout value for a 
WAN, if any, interconnecting the Fibre Channel islands. The 
valid values range from 1 000 to R_A_TOV/4. 

Maximum hop count (MAX_HOP_COUNT) is an integer 
denoting the maximum hops a frame might have to take to reach 
any destination port from any source port across the fabric. 
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End-device RSCN This specifies the transmission mode of registered state change 

Transmission Mode notification (RSCN) extended link service (ELS) to the end 

devices: 

0 Single process ID (PID) for each payload 

1 Multiple PIDs for each payload 

2 Fabric-format RSCN only 

This command cannot be executed on an enabled system; you must first disable the system using the 
switchDisable command. 

See Chapter 2 for more information. 

Operands 

none 

Examples 

To configure the fabric-related MP Router configuration parameters: 

switch : admin> configure 

Fabric parameter set. <cr> to skip a parameter 

Domain: (1..239 or f ( f abric_assign) ) [100 unconfigured] 

BB Credit: [1. .32] [16] 

R_A_TOV: (4000. .120000) [10000] 

E_D_TOV: (1000.. 5000) [2000] 2500 

Data field size: (256.. 2112) [2112] 

Switcli PID Address Mode (1..2) [2] 

WAN_TOV (1000 . .R_A_T0V/4 ) [0] 

MAX_HOP_COUNT (7.. 19 ) [7] 

End-device RSCN Transmission Mode {0..2) [1] 
Fabric configuration set 

You must run switclienable to return tine switcli bacli to running state. 

See also 

configDe fault 
conf igSliow 
switcliDi sable 
switclnEnable 
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configureZoning 

Configures zone configuration parameters. 

Synopsis 

conf igurezoning 

Availability 

admin 

Description 

Use this command to configure zoning-related parameters. The parameters are as follows: 

Disable NodeName Zone yes Disables or ignores the node name (node WWN) 

Checking members in the zone. 

no Enables the node name (node WWN) members in 

the zone. 

Hard Zoning Supported yes Enables hard zoning support. 

no Disables hard zoning support. 

Operands 

none 

Examples 

To enable configuration zone parameters: 

switch : adinin> conf igurezoning 

Zoning parameter set. <cr> to skip a parameter 
Disable NodeName Zone Checking (yes, y, no, n) : [yes] y 
Hard Zoning Supported (yes, y, no, n) : [no] 
Zoning configuration changed 

See also 

conf igZoningSliow 
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configZoningShow 



Displays zoning configuration parameters. 



Synopsis 



conf igzoningshow 



Availability 

all users 

Description 

Use this command to display zoning-related parameters. The parameters are as follows: 



disableNodenameZone 



yes Ignores the node name (node WWN) members in 
the zone. 

no Enables the node name (node WWN) members in 

the zone. 



HardZoningSupported 



yes Enables hard zoning support, 
no Disables hard zoning support. 



Operands 



none 



Examples 



To display the zoning configuration parameters: 

switch : admin> conf igzoningshow 
Zoning configuration: 



fabric . ops . disableNodenameZone : yes 
fabric . ops . HardZoningSupported : no 



See also 



conf igureZoning 
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crossPortTest 



Tests the wire-side transmitting and receiving paths between two ports. 

Synopsis 

crossporttest [-p port_list] [-n fraine_count] [-1 length] [-s speed] 
[-m mac] 

Availability 

admin 

Description 

Use this command to test the wire-side connection between two ports. This test generates frames from one 
port and sends them through an external fiber to another port. 

Each participating port is both a frame producer and a frame consumer. The transmitting and receiving 
operations occur in parallel. The transmitter attempts to send frames, independent of the status of the 
receiver. 

All ports involved in the test must be diagnostics-enabled (using portDiagEnable) prior to running this 
test. 

Operands 

This command has the following optional operands: 

-p port_list Specifies a list of source ports. The default value is all ports. 

-n frame_count Specifies the number of frames to send to each destination. The default value 

is 256. 

-1 length Specifies the payload length of the test frames. The default value is 1024. 

-s speed Specifies Fibre Channel speed mode. The default value is 2 Gb. 

0 autonegotiation 

1 1 Gb 

2 2 Gb 

-m mac Specifies the MAC layer to activate. The default is Fibre Channel. 

0 Fibre Channel 

1 Gigabit Ethernet 

Examples 

To send out 1024 frames from ports 1 2 and 1 3 in Fibre Channel mode: 

switch : adinin> crossporttest -p 12-13 -n 1024 -1 2048 
crossporttest -p 12-13 -n 1024 -1 2048 -s 2 -m 0 

Port Tx fr Tx bytes Rx fr Rx bytes Deli Size In Out RSLT 



OOOC 00000400 000000207000 00000400 000000207000 0000 0000 0000 0000 PASS 
OOOD 00000400 000000207000 00000400 000000207000 0000 0000 0000 0000 PASS 
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To send out 1024 frames from ports 1 2 and 1 3 in gigabit Etfiernet mode: 



swi tch : admin> 


crossporttest -p 12-13 -n 1024 -1 


1024 - 


-m 1 








crossporttest 


-p 12-13 -n 1024 -1 1024 -s 2 -m 1 












Port Tx fr 


Tx bytes Rx fr Rx bytes 


CrcT 


CrcR 


BadT 


BadR 


RSLT 


OOOC 00000400 


000000104800 00000400 000000104800 


0000 


0000 


0000 


0000 


PASS 


OOOD 00000400 


000000104800 00000400 000000104800 


0000 


0000 


0000 


0000 


PASS 



See also 

portDiagDi sable 
portDiagEnable 
portLoopbackTest 
spinSilk 
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date 



Displays or sets date and time. 

Synopsis 

date [-nu] [-r seconds] [+format] 
date [ [ [ [ [cc] yy] mm] dd] hh] mm [ . ss ] 

Description 

Use this command to display the current date and time. Providing arguments formats the date and time in 
a user-defined method or sets the date. Only admin can set the date. The date is read-only if 
tsClockServer is set to an external time server. 

Operands 

This command has the follov/ing optional operands: 

-n The utility named timed (a time server daemon) synchronizes the clocks 

on groups of machines. By default, if timed is running, date sets the 
time on all the machines in the local group. The -n option stops date 
from setting the time for any machine other than the current machine. 

-r Prints the date and time that is seconds from the epoch. 

-u Displays or sets the date in UTC (Coordinated Universal Time). 

An operand with a leading plus sign (+) signals a user-defined format string that specifies the format in 
which to display the date and time. The format string can contain any of the conversion specifications 
described in the strf time manual page, as well as any arbitrary text. A <newline> character is 
always displayed after the characters specified by the format string. 

The format string for the default display is: 

%a %b %e %H:%M:%S %Z %Y 

If an operand does not have a leading plus sign, it is interpreted as a value for setting the current date and 
time of the system. The canonical representation for setting the date and 
time is: 

cc The first two digits of the year (the century). 

yy The second two digits of the year. If yy is specified but cc is not, a value 

for yy between 69 and 99 results in a cc value of 1 9. Otherwise, a cc 
value of 20 is used. 

mm The month of the year, from 01 to 12. 

dd The day of the month, from 01 to 31 . 

hh The hour of the day, from 00 to 23. 

mm The minute of the hour, from 00 to 59. 

ss The second of the minute, from 00 to 61 . 

Everything but the minutes is optional. 

Time changes for Daylight Saving time. Standard time, leap seconds, and leap years are handled 
automatically. 
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Examples 

To display the date and time: 

switch: admin> date '+DATE: %m/%d/%Y%nTIME : %H:%M:%S' 

To set the date to June 1 3, 2003, 4:27 PM: 

switch: admin> date 8506131627 
To set the time to 2:32 PM without modifying the date: 

switch : admin> date 1432 

See also 

timeZoneSet 
tsClockServer 
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diagDisablePost 

Disables power-on self-test (POST) diagnostics. 

Synopsis 

diagdisablepost 

Availability 

admin 

Description 

Use this command to disable POST. POST is skipped on the next MP Router reboot. 

Operands 

none 

Examples 

To disable POST: 

switch :adinin> diagdisablepost 

See also 

diagEnablePost 
diagPost 
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diagEnablePost 

Enables POST diagnostics. 

Synopsis 

diagenablepost 

Availability 

admin 

Description 

Use this command to enable POST. Reboot the MP Router after enabling it to run POST. 

Operands 

none 

Examples 

To enable POST: 

switch : admin> diagenablepost 

See also 

diagDisablePost 
diagPost 
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diagHelp 

Displays diagnostic commands. 

Synopsis 

diaghelp 

Availability 

admin 

Description 

Use this command to display diagnostic commands. 

Operands 

none 

Examples 

To display the list of diagnostic commands: 



switch : adinin> diaghelp 




burninerrshow 


Display the burn-in errors of the switch 


t)u]minstatu.s 


Display the diagnostics burnin status 


crossporttest 


Test the wire-side transmitting and receiving 
paths between two ports 


diagdisablepost 


Disable diagnostic POST 


diagenablepost 


Enable diagnostic POST 


diaghelp 


Display list of diagnostic commands 


diagportmem 


Test particular port's specific memory 


diagportmemarm 


Test particular port ' s memory subsystem by 
port ' s internal CPU 


diagportmailbox 


Functional tests to test internal service 
modules of port asic (Figero) 


diagpost 


Set or display diagnostic POST configuration 


diagsetburnin 


Initialize the switch for a burnin run 


diagsetcycle 


Set diagnostic script parameters 


diagstopburnin 


Terminate burnin run on a switch 


portdiagenable 


Enable port for diagnostic 


portdiagdisable 


Disable port for diagnostic 


portdiagclear 


Clear diagnostic error on a port 


portloopbacktest 


Test the wire-side transmitting and receiving 
paths of the port 


spinsilk 


Test both the wire-side and crossbar-side 
operations of the port 


celloportest 


Functional test of switch fabric ports 



See also 

none 
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diagPortMailbox 

Tests the internal service modules of the port ASIC. 

Synopsis 

diagportmailbox -p port_index -m mailbox_service_type 

Availability 

admin 

Description 

Use this command to test the accelerator logic of the port ASIC. The actual tests are executed by the 
embedded port processors. 

The port involved in the test must be diagnostics-enabled (using portDiagEnable) prior to running 
this test. 

Operands 

This command has the follov/ing required operands: 

-p port_index Specifies a port index (0 to 15). The default value is 

port 0. 

-m inailbox_service_type Specifies a mailbox service type. The default value 

is 1 . The possible values include: 



1 Test queue manager 

2 Test feeder engine 

3 Test lookup service 

4 Test D-TCM CRC 

5 Test SRAM counter 

6 Test copy SRAM to D-TCM 

7 Test copy D-TCM to SRAM 

8 Test copy wire DRAM to scratch 

9 Test copy Xbar DRAM to scratch 

10 Test copy scratch to v/ire DRAM 

11 Test copy scratch to Xbar DRAM 

12 Test copy D-TCM to scratch 



Examples 

To test port 0 internal module service of copying wire D-TCM to CRC: 

switch : admin> diagportmailbox -p 0 -m 4 

PASS: diagportmailbox port[0] mbox_tYpe[l] result [0] 

See also 

portDiagDi sable 
portDiagEnable 
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diagPortMem 



Tests the specific memory of a particular port. 



Synopsis 

diagportmem -p port_index -m i:neinory_type [-t test_data ^pattern] 
[-f testing_size_f actor] 

Availability 



Use this command to test the memory subsystem of a particular port. The data write/ read test executes the 
address and data bus verifications by running address-hashing patterns or incremental-data patterns in the 
entire memory. When all memories are written with patterns, the memories are read and compared 
against the data previously written. 

The port involved in the test must be diagnostics-enabled (using portDiagEnable) prior to running this 
test; otherwise, the command is rejected. 



admin 



Description 



Operands 



This command has the following operands: 



-m i:neinory_type 



p port_index 



Specifies a port index (0 to 15).The default value is 0. 

Specifies a specific memory type inside the port. 
Possible values include: 

1 Test context memory 

2 Test cell buffer memory 

3 Test frame sequence memory 

4 Test wire RX buffer 

5 Test wire TX buffer 

6 Test frame classification memory 



7 Test code SRAM 

8 Test data SRAM 



-t test_data_pattern 



9 Test scratch memory 

Specifies the testing data pattern. Possible values 
include: 

1 Address-hashing pattern (default) 

2 Incremental-data pattern 
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-f testing_size_f actor Specifies testing size. The default is 1 (all). Possible 

values include: 

1 Review the entire tested memory type block 

2 to 8 Test size (memory type block size / factor) 

Examples 

To test port 0 context memory by using incremental-data pattern: 

switch : admin> diagportmem -p 0 -m 1 -t 2 

PASS: diagportmailbox port[0] mbox_tYpe [ 1 ] result [0] 

See also 

diagPortMemArm 
portDiagDi sable 
portDiagEnable 
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diagPortMemArm 



Tests a particular memory subsystem by internal port CPU. 

Synopsis 

diagportmemarm -p port_index -m memory_type 
[-f testing_size_f actor] 

Availability 

admin 

Description 

Use this command to test particular port-specific memories. The tests are run by the internal port CPU. The 
data write/ read test executes the address and data bus verifications by running both the address-hashing 
pattern and the incremental-data pattern in the entire memory. When all memories are written with 
patterns, the memories are read and compared against the data previously written. 

The port involved in the test must be diagnostics-enabled (using portDiagEnable) prior to running 
this test. 

Operands 

This command has the following operands: 

-p port_index Specifies a port index (0 to 15). The default value is 0. 

-m i:neinory_type Specifies a specific memory type inside the port. Possible 

values include: 

1 Tests wire DRAM (default) 

2 Tests Xbar DRAM 

-f testing_size_f actor Specifies testing size. Possible values include: 

1 Review the entire specified memory type block 
(default) 

2 Test size (memory type block size / factor) 

Examples 

To test port 0 wire DRAM: 



switch : adinin> diagportmemarm -p 0 -m 1 

PASS: diagportmemarm port[0] mem_type[l] factor [1] result [0] 



See also 

diagPortMem 
portDiagDi sable 
portDiagEnable 



XPath OS 7.4.x command reference guide 61 



diagPost 

Sets or displays diagnostic power-on self-test (POST) configuration. 

Synopsis 

diagpost [mode] 

Availability 

admin 

Description 

Tfiis command enables and disables POST. For Post to run, the MP Router must be rebooted after enabling 
POST. 



■2^ NOTE: By default, POST is enabled. 



Operands 

This command has the following operand: 

mode Specifies the mode as 1 (enabled) or 0 (disabled). If a mode is 

not specified, the currently set mode is displayed. 

Examples 

To enable POST: 

switch : admin> diagpost 1 

See also 

diagDisablePost 
diagEnablePost 
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diagSetBurnin 

Initializes the MP Router for a burn-in run. 

Synopsis 

diagsetburnin [script \ -current] 

Availability 

admin 

Description 

Use this command to set up the MP Router burn-in parameters for the registered burn-in script. The burn-in 
starts at the next reboot. 

The errors and activity logs are stored in nonvolatile memory. The activity log of the script is saved in 
/var/ log/ scriptriame. 1 . log. The errors produced are available in the error log saved in 
/^ar /log/ scriptname . 1 . log. fail. When pov/er cycles occur, the burn-in activity is restarted at 
the test run that was interrupted at the time of the pov/er cycle. This command does not require a reboot to 
take effect. 



\^^)f NOTE: The MP Router runs in diagnostic mode during and after the burn-in cycle. Supported commands 
t— I in this mode are diagSetBurnin, diagSetCycle, diagStopBurnin, burninErrShow, and 

burninStatus. Users can access these commands through the Telnet session. To return to normal mode, 
either v/ait for the burn-in cycle to complete or enter the diagStopBurnin command and then reboot the 
MP Router. 



Operands 

This command has the following operands: 

script Specifies the name of the burn-in script to run. 

-current Sets the name of the burn-in script to the current burn-in script. 

Examples 

To initialize the MP Router for a burn-in run: 



switch : adinin> diagsetburnin -current 






existing script is: switchburnin . sh 






diagpost: post mode set to 1 






diagmode: diag mode set to burnin 






Burnin mode is Enabled. 






Removing all log files in /var/log. 






burninSetName switchburnin . sh -noupdate 






burnin name is now switchburnin . sh 






Config update Succeeded 






WARNING: The switch has been set up for a 
take effect at the next reboot . To cancel 
the diagstopburnin command. 


burn- in run. 
the burn- in 


The burn-in will 
operation, enter 



See also 

diagSetCycle 
diagStopBurnin 



XPath OS 7.4.x command reference guide 63 



diagSetCycle 

Sets diagnostic script parameters. 

Synopsis 

diagsetcycle script [-show | -default | [-keyword value ... ]] 

Availability 

admin 

Description 

Use this command to provide an interactive method to update diagnostic command parameters. 
Specifying script v/ithout parameters displays all configuration variables used by the specified script 
and initiates an interactive session. Using the full stretched (that is, specifying the keyv/ord and value pair) 
option parameters updates the variables non interactively. 

In interactive mode, the current value, default value, and purpose of each variable are displayed for each 
variable. Enter a nev^ value to update the current value, which is stored in the configuration database; 
otherv/ise, the value does not change. The change does not require a reboot to take effect. 

Operands 

This command has the follov/ing operands: 

script Specifies which script parameters to edit. 

-show Displays the parameters for a diagnostic script specified by 

script. 

-default Sets script parameters to default values. 

-keyword value Updates script parameters. The keyword is the keyword to 

update (see keywords in the example that follows); the value 
should be specified manually. 

Examples 

To set diagnostic script parameters: 

switch : admin> diagsetcycle switchburnin. sh -show 

CURRENT- KEYWORD: DEFAULT 

1 - log_length: 1 

1- number_of_runs : 1 

1- volt_show_run : 1 

1 - asic_rev_run : 1 

1 - temp_show_run : 1 

1- sfp_show_run: 1 



See also 

diagSetBurnin 
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diagStopBurnin 

Terminates the burn-in run on an MP Router. 

Synopsis 

diagstopburnin 

Availability 

admin 

Description 

Use this command to determine which process ID (PID) is running burn-in on an MP Router and to 
terminate that activity. The burn-in script handles the logging cleanup. The change does not require a 
reboot to take effect. 

Operands 

none 

Examples 

To terminate the burn-in run: 

switch : admin> diagstopburnin 

No burnin script active. 

switchbeacon : done burnin script!!! 

burninerrshow output : 

errLog is empty 

diagpost: post mode set to 1 

diagmode: diag mode set to normal 

See also 

diagSetBurnin 



XPath OS 7.4.x command reference guide 65 



diagUpload 



Uploads diagnostic information from daemons and an application to an FTP server. 



Synopsis 



diagupload -h hostName -d destinationDirectory 
-u userName -p password [-f fileName] 



Availability 

admin 

Description 

Use this command to upload the core dumps and supportShow information in the /usr/cores 
directory or to upload a specified core-dump file to a specified FTP server. 

The diagUpload command might fail for the following reasons: 

• The host is not known to the MP Router. 

• The host cannot be reached by the MP Router. 

• The user does not have permission on the host. 

• The FTP server is not running on the host. 



Operands 



The following operands are required: 

-h hostName 

-d destinationDirectory 
-u userName 
-p password 

The following operand is optional: 

- f fil eName 



Specifies the host name of an FTP server. 
Specifies the destination directory. 
Specifies the user name for the FTP server. 
Specifies the password for the user account. 



Specifies a core-dump file name. Without the 
-f option, the supportShow command runs 
internally to collect diagnostic information 
and all core dumps upload to the specified 
location. 



Examples 



To upload core dumps to /tmp (if /tmp is available) to 10.7.32.168: 

switch : admin> diagupload -h 10.7.32.168 -d /tmp -u root -p password 

To upload a specified core-dump file to tmp (in this example, tmp is in the root home directory) to 
10.7.32.168: 



switch: admin> diagupload -h 10.7.32.168 -d tmp -u root -p password 
-f /usr/cores/xyz . core 



See also 



supportShow 
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dIsReset 



Turns off the dynamic load sharing option. 



Synopsis 

dlsreset 



Availability 

admin 

Description 

Use this command to prevent load sharing when a fabric change occurs; otherwise, working ports could 
be affected. See dlsSet for a full description of dynamic load sharing. 



Operands 

none 

Examples 

To turn off dynamic load sharing: 



switch :admin> dlsreset 
DLS feature disabled 



See also 



dlsSet 

dlsShow 

iodReset 

iodSet 

iodShow 

trunkReset 

trunkSet 

trunkShow 
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dIsSet 



Turns on the dynamic load sharing option. 

Synopsis 

dlsset 

Availability 

admin 

Description 

Use this command to allow load sharing when a fabric change occurs. 

Routing is done on a per-source-port basis. This means that all the traffic coming in from a port (either 
E Port or Fx_Port) directed to the same remote domain is routed through the same output E Port. 

To optimize fabric utilization, when there are multiple equivalent paths to a remote MP Router, traffic is 
shared among all the paths. Load sharing occurs when a MP Router reboots. In addition, if dynamic load 
sharing is enabled, the optimal load sharing algorithm is recomputed every time a change in the fabric 
occurs (an E_Port or an Nx_Port goes up or down). 

A dynamic load sharing algorithm considers the link capability of the E Ports and the Nx Ports when 
assigning routes. For example, the algorithm attempts to assign a 2-Gb/s Nx Port to a 2-Gb/s E Port (if 
available) instead of to a 1-Gb/s E Port. 

If dynamic load sharing is turned off, load sharing is performed only at boot time, when an Nx_Port 
comes up, or when a new interswitch link (ISL) comes up. Optimal load sharing is rarely achieved with this 
setting. 

Dynamic load sharing is turned on by default. 

Notes 

When dynamic load sharing is enabled, routing changes might affect working ports. For example, if an 
Fx_Port goes down, another Fx Port might be rerouted from one E Port to a different E Port. The MP Router 
minimizes the number of routing changes, but some are necessary to achieve optimal load sharing. These 
changes might affect the application, especially if the in-order delivery option is set. With the in-order 
delivery option (see iodSet), routes are briefly not available (for a few seconds) after a fabric change. In 
addition, some frame loss might occur. No frame loss occurs if in-order delivery is off, but there is still a 
short period of time when traffic is not forwarded. This period of time is significantly shorter than when 
in-order delivery is on and is usually less than 1 second. 

Trunking overrides the dynamic load sharing setting. 
Operands 

none 

Examples 

To turn on dynamic load sharing: 

switch: admin> dlsset 
DLS feature enabled 
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See also 

dlsReset 

dlsShow 

iodReset 

iodSet 

iodShow 

nbrStateShow 

topologyShow 

trunkReset 

trunkSet 

trunkShow 

urouteShow 
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dIsShow 

Displays the state of the dynamic load sharing option. 

Synopsis 

dlsshow 

Availability 

all users 

Description 

Use this command to see whether dynamic load sharing is on (set) or off. 

Operands 

none 

Examples 

To display the state of the dynamic load sharing option: 

switch : admin> dlsshow 
DLS is set 



See also 

dlsReset 

dlsSet 

iodReset 

iodSet 

iodShow 

trunkSet 

trunkShow 
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errClear 

Clears the syslog messages. 

Synopsis 

errclear 

Availability 

admin 

Description 

Use this command to clear the syslog messages. 

Operands 

none 

Examples 

To clear the syslog messages of the MP Router: 

switch : adinin> errclear 

See also 

errShow 
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errShow 

Display the syslog messages. 

Synopsis 

errshow [-a] 

Availability 

all users 

Description 

This command displays the syslog messages, prompting the user to press Enter between each message. 
See the HP StorageWorks XPath OS 7.4.x system error messages reference guide for descriptions of 
possible error messages. 

Operands 

This command has the following optional operand: 
-a Specifies that the syslog messages are displayed without pagination. 

Examples 

To display the syslog messages of the MP Router: 

switch : admin> errshow 

See also 

errClear 
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eventActionSet 



Sets the action type for a predefined event. 



Synopsis 

eventactionset eventid actionType 

Availability 

admin 

Description 

Use this command to display or set the action type for a predefined event. 

Operands 

The following operands are required for set operation: 



actionType 



eventid 



Event identification number. 

The available action types are: 

none No action is taken. 



snmptrap 



log 



Places the event in a RAM-based event log. 
Generates a trap for the event. 



logandtrap 



Combines both log and snmptrap actions 
for the event. 



persist 



Places the event in a persistent RAM-based 
event log and in the logandtrap mode. 



Examples 



To change event action type for event ID 6: 



switch : adinin> eventactionset 6 logandtrap 



Event Action for eventid 6 is set to: logandtrap 



See also 



event Ac tionShow 



eventSeverity 
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eventActionShow 

Displays the action type for all predefined events. 

Synopsis 

eventactionshow [eventID] 

Availability 

all users 

Description 

Use this command to display the action type for all predefined events. 

Operands 

The follov/ing operand is optional: 

event ID Specifies a predefined event. 

If an operand is specified, the action type of the specified event is displayed. 

Examples 

To display the event action type for event 1 0: 



switch : admin> eventactionshow 10 
Eventid EventDesc 


Action 


10 Fan removed 


logandtrap 


To display the event action type for all predefined events: 


switch : admin> eventactionshow 



See also 

event Ac tionSet 
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eventClear 

Clears the MP Router event log. 

Synopsis 

eventclear [-p] 

Availability 

admin 

Description 

Use this command to clear the MP Router event log. 

Operands 

The following operand is optional: 

-p Clear events only from the persistent event log. 

If no operand is specified, this command clears the event log in RAM; the persistent event log is not 
cleared. If the -p option is specified, on/y the persistent event log is cleared and the error log in RAM is 
not cleared. 

Examples 

To clear the event log in RAM: 

switch :adinin> eventclear 
To clear the persistent event log: 

switch : adinin> eventclear -p 

See also 

eventShow 
event ShowByNum 
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eventLogSize 



Displays or sets the event log size. 



Synopsis 



event logs ize [LogSize] 



Availability 



admin 



Description 



Use this command to display or to set the event log size, v/hich controls the maximum number of events 
captured in the event log. The event log v^raps around if the number of events captured reaches the log 
size. The event log size is betv/een 100 and 2000, in increments of 100. By default, the event log size is 



NOTE: Events currently captured in the event log are cleared v/hen the event log size is changed. 



The number of events logged in the event log table is one less than the event log size. 



Operands 

The follov/ing operand is optional: 



Examples 

To display the event log size: 



switch : admin> eventlogsize 
Event Log Size is: 1000 



To set the event log size to 1 200: 



switch : admin> eventlogsize 1200 
Event Log Size is: 1200 



1000. 




LogSize 



Specifies the event log size. 



See also 



eventShow 



event ShowByNum 
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eventSeverity 

Displays or sets the severity level for a predefined event. 

Synopsis 

eventseverity eventid severityLevel 

Availability 

admin 

Description 

Use this command to display or set the severity level for a predefined event. 

Operands 

The following operands are required: 

eventid Event identification number 

severityLevel The available severity levels are: 

panic Indicates a failure that causes the MP Router to 

malfunction. 

critical Indicates a failure that affects data traffic among 
ports. 

error Indicates a failure that affects data traffic on a single 

port. 

warning Indicates a temporary failure that does not affect data 
traffic. 

info Indicates an informational event. 

debug Indicates an event for debugging purposes. 

Examples 

To display the event severity level for event ID 6: 

switch : admin> eventseverity 6 

Event severity for event ID 6 is: info 

To change the event severity level to error for event ID 6: 

switch : admin> eventseverity 6 error 

Event severity for event ID 6 sets to: error 



See also 

eventActionSet 

eventSeverityShow 

eventShow 
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eventSeverityShow 

Displays the severity level for all predefined events. 

Synopsis 

events ever ityshow 

Availability 

all users 

Description 

Use this command to display the severity level for all predefined events. 

Operands 

none 

Examples 

To display event severity level: 

switch : admin> eventseverityshow 

See also 

event Severity 
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eventShow 



Displays the events in the event log. 

Synopsis 

eventshow [-m minutes] [-a] [-n numOf Events] 

Availability 

all users 

Description 

Use this command to display all events in the event log by default. To display events that occurred v/ithin a 
previous number of minutes, use the -m operand.. The -a operand displays events v/ithout pagination. The 
-n operand specifies the number of events to display. The timestamp field of each event includes date, 
time, and GMT offset. 

The output of the eventshow command includes events recorded in the persistent error log during 
previous runtime cycles and event messages logged in the current runtime cycle. 

There are two types of memory in v/hich log entries are stored: RAM and persistent RAM. All events are 
placed in the RAM-based event log. Only events from RAM are displayed by the eventshow command. 
Certain events also are stored in persistent RAM. When an MP Router reboots, RAM clears and then 
reloads with log entries from persistent RAM. Running the eventshow command after a reboot displays a 
log of the persistent events and any additional new log entries during bootup. 

Both the persistent RAM log and the RAM log are limited in space and are managed as circular buffers. 
When either log overflows, new entries overwrite the old entries. 

Operands 

The following operands are optional: 

-m minutes Causes only events that occurred within the number of minutes 

specified by minutes to be displayed. 

-a Specifies that events be displayed without pagination; otherwise, 

press Enter when prompted to display the next event log page. 

-n numOfEvents Specifies the number of events to display. 

Examples 

To display all events in the event log: 

switch ; adinin> eventshow 

To display events that occurred within the last five minutes: 

switch : adinin> eventshow 5 

To display all events, without pagination: 

switch : adinin> eventshow -a 

To display the most recent 30 events, without pagination: 

switch ; adinin> eventshow -a -n 3 0 

See also 

event ShowByNum 
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eventShowByNum 

Displays events in the event log between specific starting and ending event numbers. 

Synopsis 

eventshowbynum startingEventNumber endingEventNumber 
[-a] [-n numOf Events] 

Availability 

all users 

Description 

Use this command to display events in the event log betv/een specific starting and ending event numbers. 
This command displays all events if the starting event number is 1 and the ending event number is -1 . The 
timestamp field of each event includes date, time, and GMT offset. 

Operands 

The follov/ing operands are required: 

StartingEventNumber Specifies the starting event number. 

endingEventNumber Specifies the ending event number. 

The follov/ing operands are optional: 

-a Displays events without page breaks, 

-n numOf Events Specifies the number of events to display. 

Examples 

To display events between event number 1 0 and 1 00: 

switch : admin> eventshowbynum 10 100 
To display all events above event number 200: 

switch: adinin> eventshowbynum 200 -1 
To display all events above event number 200, without pagination: 

switch : admin> eventshowbynum 200 -1 -a 
To display the most recent 30 events, without pagination: 

switch : adinin> eventshowbynum 1 -1 -a -n 30 

See also 

eventShow 
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exit 

Terminates the shell. 

Synopsis 

exit 

Availability 

all users 

Description 

Use this command to terminate the shell and log out of the MP Router. 

Operands 

none 

Examples 

To log out of the MP Router: 

switch : adinin> exit 

See also 

quit 
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fabLogClear 

Clears the internal debug messages of the fabric controller. 

Synopsis 

f ablogclear 

Availability 

admin 

Description 

Use this command to clear the internal debug messages of the fabric controller. 

Operands 

none 

Examples 

To clear the internal debug messages of the fabric controller: 

switch : admin> f ablogclear 

See also 

f abLogShow 
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fabLogShow 



Displays the internal debug messages of the fabric controller. 

Synopsis 

fablogshow [-f] 

Availability 

admin 

Description 

Use this command to display the fabric internal debug messages of the fabric controller. 

Operands 

This command has the following optional operand: 

- f Wait for additional data to append when fabLogShow reaches 

the end of the log. 

Examples 

To display the internal debug messages of the fabric controller: 



switch : adinin> fablogshow 
Time |P |0XID| Log info 
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30 
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00 


ff ff 


Fabctl event PORT_MODE_EVENT sent to Port 0 


16 


05 


30 


650 


00 


ff ff 


st_chg: RnFCSM_LinkState to RnFCSM_SendELP 
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01 
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Xbar frame In. sid=f f f f f d, did=f f f f f d, cmd=10 , len=208 
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01 
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st_chg: RnFCSM_SendELP to RnFCSM_SendELP 
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01 
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Xbar frame out. sid=f f f f f d, did=f f f f f d, cmd=2 , len=148 
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01 


ff ff 


Fabctl event ELP_UNSUCC sent to Port 1 


16 


05 


30 


802 


01 


ff ff 


st_chg: RnFCSM_SendELP to RnFCSM_ProcessESC 


16 


05 


30 


804 


00 


08c5 


Xbar frame In. sid=f f f f fd, did=f f f f fd, cmd=10 , len=208 


16 


05 


30 


804 


00 


ff ff 


st_chg: RnFCSM_SendELP to RnFCSM_SendELP 


16 


05 


30 


804 


00 


08c5 


Xbar frame out. sid=f f f f f d, did=f f f f f d, cmd=2 , len=148 


16 


05 


30 


805 


00 


ff ff 


Fabctl event ELP_UNSUCC sent to Port 0 


16 


05 


30 


805 


00 


ff ff 


st_chg: RnFCSM_SendELP to RnFCSM_ProcessESC 


16 


05 


30 


811 


01 


OOff 


Port Msg linkstatus = 2 


16 


05 


30 


811 


01 


ff ff 


Fabctl event PORT_MODE_EVENT sent to Port 1 


16 


05 


30 


811 


01 


ff ff 


Fabctl event ESC_SUPP sent to Port 1 


16 


05 


30 


811 


01 


ff ff 


st_chg: RnFCSM_ProcessESC to RnFCSM_EPortOperation 


16 


05 


30 


811 


01 


ff ff 


Fabctl event E_P0RT_INITED sent to Port 1 


16 


05 


30 


812 


01 


ff ff 


st_chg: RnFCSM_EPortOperation to RnFCSM_SendEFP 


16 


05 


30 


812 


01 


OObe 


Xbar frame out. sid=f f f f f d, did=f f f f f d, cmd=ll , len=60 


16 


05 


30 


814 


00 


OOff 


Port Msg linkstatus = 2 


16 


05 


30 


814 


00 


ff ff 


Fabctl event PORT_MODE_EVENT sent to Port 0 


16 


05 


30 


814 


00 


ff ff 


Fabctl event ESC_SUPP sent to Port 0 


16 


05 


30 


815 


00 


ff ff 


st_chg: RnFCSM_ProcessESC to RnFCSM_EPortOperation 


16 


05 


30 


815 


00 


ff ff 


Fabctl event E_P0RT_INITED sent to Port 0 


16 


05 


30 


815 


00 


ff ff 


st_chg: RnFCSM_EPortOperation to RnFCSM_SendEFP 


16 


05 


30 


815 


00 


OObf 


Xbar frame out. sid=f f f f f d, did=f f f f f d, cmd=ll , len=60 


16 


05 


30 


815 


00 


OOff 


Port Msg linkstatus = 2 


16 


05 


30 


815 


00 


ff ff 


Fabctl event PORT_MODE_EVENT sent to Port 0 


16 


05 


30 


818 


01 


08c8 


Xbar frame In. sid=f f f f f d, did=f f f f f d, cmd=ll , len=60 


16 


05 


30 


819 


01 


08c8 


Xbar frame out. sid=f f f f f d, did=f f f f f d, cmd=2 , len=60 


16 


05 


30 


824 


01 


OObe 


Xbar frame In. sid=f f f f f d, did=f f f f f d, cmd=2 , len=60 


16 


05 


30 


824 


01 


OObe 


SWILSReply - cmd =11 



See also 

f abLogClear 
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fabricShow 

Displays fabric membership information. 

Synopsis 

f abricshow 

Availability 

all users 

Description 

Use this command to display information about MP Routers and switches in the fabric. 

If the fabric is reconfiguring, some or all MP Routers might not be shown; otherwise, the following fields 
are displayed: 

Switch ID The domain_ID and embedded port D_ID 

World Wide Name The world wide name (WWN) 

Enet IP Addr The Ethernet IP address 



Examples 



Name The symbolic name (> 


indicates the 


principal 


MP Router) 


none 








To display information about MP Routers in a fabric: 








switch : admin> fabric show 








SwitchID Worldwide Name 


Enet IP 


Addr 


Name 


2:fffc02 10:00:00:60:69:22:0b:3e 

100:fffc64 10:00:00:05:le:00:08:00 
The fabric has 2 switches 


10.7.32. 
10.7.32. 


67 
249 


" switch" 
>"MY_SYS_NAME" 



See also 

switchShow 
topologyShow 



84 XPath OS CLI commands 



fanShow 

Displays fan status. 

Synopsis 

f anshow 

Availability 

all users 

Description 

Use this command to display current fan status. Tfie number of fans migfit vary witfi different ctiassis types. 
Fan status is indexed by sequential numbers and includes OK, fail, and not_present. Speed settings 
are normal and high. If the fan status is OK, the Actual_speed field displays the fan RPMs; otherwise, 
it displays N/A. The chassisShow command also provides the fan status. 

See the setFanSpeed command for information on fan speed settings. 

Operands 

none 

Examples 

To display fan status: 



switch : admin> f anshow 












Fan 1 


Status: OK Set_speed 


NORMAL 


Actual, 


_speed 


2721 


RPM 


Fan 2 


Status: OK Set_speed 


NORMAL 


Actual, 


_speed 


2721 


RPM 


Fan 3 


Status: OK Set_speed 


NORMAL 


Actual, 


_speed 


2657 


RPM 


Fan 4 


Status :NOT_PRESENT 












Fan 5 


Status :NOT_PRESENT 












Fan 5 


Status :NOT_PRESENT 













See also 

chassisShow 

psShow 

setFanSpeed 
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fastBoot 

Reboots the MP Router, bypassing POST diagnostics. 

Synopsis 

f astboot 

Availability 

admin 

Description 

This command is equivalent to the reboot command except that fastBoot causes the startup routine to 
omit POST diagnostics (for the next reboot only). 



A CAUTION: This command does not require a confirmation. The MP Router immediately enters the reboot 
stage after the command is issued. 



Operands 

none 

Examples 

To reboot the MP Router: 

switch : admin> f astboot 

See also 

diagDisablePost 
diagEnablePost 
diagPost 
reboot 
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fazoneAdd 

Adds a Fabric Assist (FA) zone. 

Synopsis 

fazoneAdd " fazon eNam e"," fazon eMemberL ist" 

Availability 

admin 

Description 

This command adds a member to an existing FA zone. 



'2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cf gEnable command. 

For the change to be preserved across MP Router reboots, save it to nonvolatile memory using the 
cfgSave command. 



Operands 

The follov/ing operands are required: 

" fazoneName" Specifies the name for the Fabric Assist zone, enclosed in 

quotation marks. 

" fazoneMemberList" Specifies a list of Fabric Assist Zone members, enclosed in 

quotation marks, with each member separated by a semicolon. 
A member can be specified by one or more of the follov/ing 
methods: 

• Enter a fabric domain and area number pair. View the 
area numbers for ports using the switchShow command. 

. WWN 

• Fabric Assist zone alias name 

Examples 

To add aliases for some disk arrays to the Fabric Assist zone, Blue_fazone: 

switch : adinin> fazoneAdd "Blue_f azone" , "arrayS ; arraY4; arrayS" 

To add a Fabric Assist host member to Fabric Assist zone, Blue_fazone: 

switch : admin> fazoneAdd "Blue_f azone" , "h{5,6}" 



XPath OS 7.4.x command reference guide 87 



See also 



cf gEnable 
cf gSave 
cf gShow 
f azoneCreate 
f azoneDelete 
f azoneRemove 
f azoneShow 
switchShow 
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fazoneCreate 

Creates a Fabric Assist (FA) zone. 

Synopsis 

fazonecreate " fazon eNam e"," fazon eMemberL ist" 



Availability 

admin 

Description 

Use this command to create a new FA zone, fazoneName, which must be unique among all other zone 
objects. fazoneMemberList is a semicolon-separated list of one or more WWNs, domain,port pairs, 
FA zone alias names, or it can be exactly one FA host member. 

A FA zone name is a C-language-style name. It must begin with a letter and be followed by any number of 
letters, digits, and underscore characters. Names are case sensitive; for example, Fazone_l and fazone_l 
are different Fabric Assist zones. Spaces are ignored. 

The FA zone member list must have at least one member. Empty lists are not allowed. 

When a FA zone member is specified by physical fabric port number, any and all devices connected to 
that port are in the FA zone. 

WWNs are specified as eight hexadecimal numbers separated by colons, for example, 
10:00:00:60:69:00:00:8a. Zoning has no knowledge of the fields within a WWN; the 8 bytes are 
simply compared with the node and port names presented by a device in a login frame (FLOGI or PLOGI). 

When a FA zone member is specified by node name, then all ports on that device are in the FA zone. 
When a FA zone member is specified by port name, only that single device port is in the FA zone. Zone 
alias names have the same format as FA zone names and are created with the aliCreate command. 
The alias must resolve to a list of one or more physical fabric port numbers, or WWNs, or to a FA host. 

A FA host member is defined by wrapping the physical fabric port or a physical device (a WWN) 
between "H{and }". For example, "H{5,6}" and "H{1 0:00:00:60:69:00:00:8a}" are FA hosts. The type 
of FA zone members used to define a FA zone may be mixed and matched. For example, a FA zone 
defined with the members 2,12; 2,14; 10:00:00:60:69:00:00:8a would contain devices connected to 
MP Router 2, ports 1 2 and 14, and the device with a WWN of 10:00:00:60:69:00:00:8a (either node 
name or port name— whichever port in the fabric it is connected to.) 



'2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cf gEnable command. 

For the change to be preserved across MP Router reboots, save it to nonvolatile memory using the 
cfgSave command. 



XPath OS 7.4.x command reference guide 89 



Operands 



The following operands are required: 

" fazon eNam e" 



' fazoneMemberLi s t" 



Examples 



Specify a name for the Fabric Assist zone. The name must be 
enclosed in quotation marks. 

Specify a member or list of members to add to a Fabric Assist 
zone. The list must be enclosed in quotation marks, and each 
member must be separated by a semicolon. A member can be 
specified by one or more of the following methods: 

• A fabric domain and area number pair. (View the area 
numbers for ports using the switchShow command.) 

• WWNs. 

• Fabric Assist zone alias names. 

• Exactly one Fabric Assist host member. 



To create two Fabric Assist zones using a mixture of port numbers and Fabric Assist zone aliases: 



switch : adinin> fazoneCreate "fazonel", "h{1,1}; arrayl; 1,2; array2" 
switch : admin> fazoneCreate "fazone2", "1,0; H{1,2}; array2" 



See also 

aliCreate 
cf gEnable 
cf gSave 
cf gShow 
f azoneAdd 
f azoneDelete 
f azoneRemove 
f azoneShow 
switchShow 
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fazoneDelete 



Deletes a Fabric Assist (FA) zone. 



Synopsis 

fazoneDelete " fazoneName" 

Availability 

admin 

Description 

Use this command to delete an existing FA zone on a fabric. 



NOTE: This command changes the defined configuration (see cf gShow). For the change to become 



effective, you must enable an appropriate zone configuration using the cf gEnable command. 
For the change to be preserved across MP Router reboots, save it to nonvolatile memory using the cf gSave 




command. 



Operands 



The following operand is required: 



fazoneName 



Specifies the name of the zone to be deleted, in quotation marks. 



Examples 



To delete a Fabric Assist zone: 



switch : admin> fazoneDelete "Blue_fazone 



See also 



f azoneAdd 



f azoneCreate 



f azoneShow 
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fazoneRemove 



Removes members from a Fabric Assist (FA) zone. 

Synopsis 

fazoneRemove " fazoneName", " fazoneMemberList" 



Availability 

admin 

Description 

Use this command to remove one or more members from an existing Fabric Assist zone. 

Each deleted member must be found by an exact string match. Order is important v/hen removing multiple 
members of a FA zone. For example, if a Fabric Assist zone contains array2; arrayS; array4, then 
removing array4; arrayS fails, but removing arrayS; array4 succeeds. If issuing this command results in all 
members being removed, the FA zone is deleted. 



[2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cfgEnable command. 

For the change to be preserved across MP Router reboots, save it to nonvolatile memory using the cf gSave 
command. 



Operands 

The follov/ing operands are required: 

"fazoneName" Specifies a name for the FA zone, in quotation marks. 

"fazoneMemberList" Specifies a member or list of members to remove from a FA 

zone. The list must be enclosed in quotation marks, and each 
member must be separated by a semicolon. A member can be 
specified by one or more of the following methods: 

• A fabric domain and area number pair. View the area 
numbers for ports using the switchShow command. 

• WWNs 

• Fabric Assist zone alias names 

• Exactly one Fabric Assist host member 

Examples 

To remove array2 from the FA zone, Blue_fazone: 

switch : admin> fazoneRemove "Blue_f azone" , "arraY2" 

See also 

f azoneAdd 
f azoneCreate 
f azoneDelete 
f azoneShow 
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fazoneShow 



Displays Fabric Assist (FA) zone information. 

Synopsis 

fazoneshow [pattern] 

Availability 

all users 

Description 

Use this command to display FA zone information. Specifying this command with no parameters or with 
the second parameter set to zero displays all Fabric Assist zone configuration information for both defined 
and effective configurations. Defined configuration information is shown from the transaction buffer. See 
the cfgShow command for a description of this display. 

If an operand is specified, it is used as a pattern to match Fabric Assist zone names, and those that match 
in the defined configuration are displayed. 

Operands 

This command has the following optional operand: 

pattern Specifies a value to search for the name of a Fabric Assist zone. 

This can be any portable operating system interface (POSIX)-style 
expression. Patterns can contain: 

• Question mark (?), which matches any single character 

• Asterisk (*), which matches any string of characters 

• Ranges that match any character within the range, for 
example, [0-9] or [a-f] 

Examples 

To display all FA zones beginning with the letters A through C: 

switch : ac3inin> fazoneShow "[A-C]*" 
fazone: Blue_fazone 
1,1; arrayl ; 1,2; arraY2 

See also 

cf gShow 
f azoneAdd 
f azoneCreate 
f azoneDelete 
f azoneRemove 
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fcipShow 



Displays the status of an FCIP port. 



Synopsis 



fcipshow port [-r] 



Availability 

admin 



Description 

Use this command to display all configuration information and the current status for an FCIP port. In 
addition, this command displays FCIP layer counters. 



Operands 



This command has the following operands: 



port 
-r 



Specifies the FCIP port (required) 
Resets the counters (optional) 



Examples 



To display information about FCIP port 8: 



switch: admin> fcipshow 8 



State: 

Local IP addr: 
Remote IP addr: 
Link Bandwidth: 
Jumbo Support : 
WAN_TOV timeout 
Remote WWN: 



fcip protocol info (port 8) 

Configured 

UP 

192 .168.250.6 
0.0.0.0 

1000 

enabled 

enabled 

00:00:00:00:00:00:00:00 



Current 
UP 

192.168.250.6 
0.0.0.0 

1000 

enabled 

enabled 

00:00:00:00:00:00:00:00 



Time sync state: synchronized (Since Tue Jul 13 17:48:27 2004) 



in_f rame_ip : 
in_f rame_f c : 
out_f rame_ip : 
out_f rame_f c : 
in_octet_ip : 
in_octet_f c : 
out_octet_ip : 
out octet fc: 



137378 

4008800 

4008800 

137378 

13007680 

8043998376 

8043998376 

806207 



(continued on next page) 
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error_f rame_ip : 


0 




error_f raine_f c : 


0 




error_resYnc : 


0 




drop frame f c : 


0 




drop_f rame_ip : 


0 




f rame_timeout : 


0 




authen_f ailure : 


0 



To display information about FCIP port 3 and reset counters: 



switch ; adinin> fcipshow 3 -r 

See also 

portCf gFcip 
portCf gGige 
portShow 
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fcrConfigure 



Sets MP Router configuration parameters. 



Synopsis 

fcr configure 

Availability 

admin 

Description 

Use this command to interactively set the MP Router configuration parameter for this MP Router. 

This command cannot be executed on an enabled system; you must first disable the system using the 
switchDisable command. 

Use this command to set the configuration parameter for this MP Router. The parameter is defined as 
follows: 

Backbone fabric ID A fabric ID uniquely identifies a fabric in MP router 

configurations. The backbone fabric is the fabric attached to the 
U_Ports (such as E/F_Ports) of this MP Router. The backbone 
fabric ID must be unique across all MP Router-connected fabrics. 

Operands 



none 



Examples 



To configure the MP Router: 



switch : ac3inin> fcrconfigure 

FC Router parameter set. <cr> to skip a parameter 
Backbone fabric ID: (1-128) [100] 

You must run switchenable to return the switch back to online state. 



See also 



switchDisable 
switchEnable 
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fcrFabricShow 

Displays MP Routers in a backbone fabric. 

Synopsis 

f erf abricshow 

Availability 

all users 

Description 

This command displays the MP Routers that exist in an MP Router backbone fabric and displays 
information about these MP Routers. 

If there are no active MP Routers present in the backbone fabric, a message is displayed that says that no 
active MP Routers have been found. An active MP Router is an MP Router with at least one enabled 
EX_Port. 

The following output is displayed for each MP Router in the backbone fabric: 
WWN The WWN of the MP Router. 

Domain ID The domain ID of the MP Router. This domain ID is relevant only in the 
backbone fabric. 

Info The Ethernet IP address and name of the MP Router 

EX_Ports The following information is displayed for each MP Router's active EX_Ports: 

EX_Port The port number for the EX_Port 

FID The fabric ID of the EX_Port 

Neighbor Switch The WWN, the Ethernet IP address and switch 

Info (WWN, enet name of the switch attached to the EX_Port. 

IP, name) 

Operands 

none 

Examples 

To display the MP Routers in the backbone fabric: 



f cr_mars_8 : 


adinin> 


f erf abricshow 










FCR WWN: 10 


:00:00: 


05 : le : 13 : 59 : 00 , DomlD: 


2, Info: 


10.32.155 


52, ■ 


f cr_mars_9 " 


EX_Port 


FID 


Neighbor Switch Info 


(WWN, enet 


IP, name) 






7 


10 


00:00:00:00:00:00:00: 


00, 10.32 


.156.33, 


mo j o_ 


_10" 


4 


116 


00:00:00:00:00:00:00: 


00, 10.32 


.156.34, 


mo j o_ 


_11" 


5 


116 


00:00:00:00:00:00:00: 


00, 10.32 


.156.34, 


mo j o_ 


_11" 


(continued 


on next 


page) 
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FCR WWN: 


10:00:00: 


05:le:12 :eO 


: 00 , Dom ID: 


100, 


Info: 10.32.156, 


.50, ' 


' f cr_mars_8 " 


EX_Port 


FID 


Neighbor 


Switch Info 


(WWN, 


enet IP, name) 






4 


95 


00:00:00: 


00:00:00:00: 


00, 


10.32.156.31, ' 


'inojo_ 


_5" 


5 


95 


00:00:00: 


00:00:00:00: 


00, 


10.32.156.31, ■ 


'mojo_ 


_5" 


6 


95 


00:00:00: 


00:00:00:00: 


00, 


10.32.156.31, ' 


'mojo_ 


_5" 



See also 

f crPhyDevShow 
f crProxyDevShow 
f crRouteShow 
IsanZoneShow 
switchShow 
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fcrPhyDevShow 



Displays MP Router physical device information. 



Synopsis 

f crphydevshow [-a all] [-f fabricid] [-w wwn] 

Availability 

all users 

Description 



This command displays the physical (real) devices that are configured to be exported to other fabrics. A 
device is considered to be configured to be exported to another fabric if it is a member of a Logical 
Storage Area Netv/ork (LSAN) zone. The device is displayed only if it is discovered in the EX_Port-attached 
fabric's Name Server (for example, the device is online). 

Physical device information is available only for physical devices that exist in fabrics attached to EX_Ports 
of MP Routers on the same backbone fabric as this MP Router. 

The default output displays only physical device information relevant to this MP Router. Relevant physical 
devices include physical devices that are configured to be exported from fabrics attached to this MP 
Router's EX_Ports. 

The physical devices are listed by fabric. Search for physical devices based on a fabric ID and port world 
v/ide name with the -f and -w operands, respectively. The message No device found appears if there 
is no physical device information available at this MP Router. 

The output displays the following columns: 

Device Exists in The fabric where the physical device exists. 



Fabric 



WWN 



Physical PID 



The WWN of the device port. 

The port ID of the real/physical device. (This port ID is relevant 
only on the fabric specified by the Device Exists in 
Fabric column.) 



Operands 



This command has the following optional operands: 



-a all 



Displays all physical devices for all MP Routers in the same 
backbone fabric, whether or not they are relevant to this MP 
Router. 



-w wwn 



-f fabricid 



Displays the physical devices in the specified fabric. 
Displays the physical devices with the specified port WWN. 
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Examples 

To display the physical devices relevant to this MP Router: 



switch : admin> f crphydevshow 








Device WWN 






Physical 


Exists 






PID 


in Fabric 








2 10:00:00:00:c9 


2b 


6a: 68 


C70000 


3 50:05:07:65:05 


84 


09:0e 


OlOOef 


3 50:05:07:65:05 


84 


0b:83 


0100e8 



See also 

f crFabricShow 
f crProxyDevShow 
f crRouteShow 
IsanZoneShow 
switchShow 
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fcrProxyConfig 

Displays and configures proxy devices presented by an MP Router. 

Synopsis 

f crproxyconf ig [ -s slot [importedFID devWWN slot]] [-r remove [importedFID 
devWWN] ] 

Availability 

admin 

Description 

Use this command to display or set the persistent configuration of proxy devices presented by the local MP 
Router. 

If no optional parameter is given, the command displays the persistent proxy device configuration; 
otherv/ise, it sets the specified attributes to their nev^ values. 

The proxy device must be inactive prior to setting or clearing persistent attributes. Disabling EX Ports (for 
example, using the portDisable command) attached to the relevant edge fabric, removing the device 
from the appropriate LSAN zones, or disabling the physical device are valid methods of ensuring a proxy 
device is inactive. 

Persistent proxy device configuration attributes apply to the local MP Router. Multiple MP Routers attached 
to the same edge fabric coordinate to present the same proxy devices. As a result, persistent proxy device 
configurations must be consistent across all MP Routers attached to the same edge fabric or results are 
unpredictable. If the persistent proxy device configuration is not altered by the administrator, no action is 
required. If the configuration is altered, then care must be taken to ensure consistency across all MP 
Routers attached to the same edge fabric. 

The follov/ing information is displayed if no optional parameter is given: 

Edge FID The imported fabric ID of the proxy device. 

Device WWN The port World Wide Name of the device. 

Slot The slot used for the device WWN. 

The device WWN-to-slot association is persistently stored. The 
slot format is XXYYH, where xx specifies the translate domain 
port number and specifies the al_pa value or the low 8 bits 
of the port ID of the proxy device (valid values include OlH to 
ffh). The port ID of the proxy device is derived from the PID 
format (for example, native, core, and extended edge) and the 
proxy device slot. 

The message All slots empty is returned if no proxy device 
WWN is stored in any slot for all edge fabrics. 
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Operands 

This command has the following operands: 

-s importedFiD devWWN slot The -s option adds the specified WWN (format: 

xx:xx:xx:xx:xx:xx:xx:xx) to the specified slot (format xxyyh, 
where xx is the translate domain port number, yy is the AL_PA) 
for the edge fabric specified (1 to 1 28). 

An error message could be displayed, depending on the 
condition that caused the error, as follows: 

• If the WWN does not exist in any slot for the specified edge 
fabric, this message is displayed: 

WWN does not exist in any proxy device 
slot. 

• If all slots are used for the specified edge fabric, this 
message is displayed: 

Too many proxy slots configured. Remove 
some unused proxy device WWNs from their 
slots using the -r option and try again. 

• If the specified slot already contains an entry, this message 
is displayed: 

The specified slot already contains a WWN, 
overwrite? (y) 

-r edgeFiD WWN The -r option removes the specified WWN (format: 

xx.xx.xx;xx;xx;xx;xx;xx) from its slot for the edge fabric 
specified by edgeFID{^ to 128). 

The following message displays if the WWN does not exist in 
any slot for the specified edge fabric: 

WWN does not exist in any proxy device 
slot. 

Examples 

To display persistent proxy device configuration: 

fcr:admin> f crproxyconf ig 

Edge FID Device WWN Slot 



002 


50 


05 


07 


65 


05 


84 


08 


d7 


fOOl 


002 


50 


05 


07 


65 


05 


84 


Oa 


7b 


f002 


002 


22 


00 


00 


20 


37 


c3 


11 


71 


fOOl 


002 


22 


00 


00 


20 


37 


c3 


la 


8a 


f002 


003 


10 


00 


00 


00 


c9 


2b 


6a 


2c 


fOOl 


004 


10 


00 


00 


00 


c9 


2b 


6a 


2c 


fOOl 



To persistently configure device WWN 00:1 1 :22:33:44:55:66:77 to use slot flOl h in fabric 5: 

fcr:admin> f crproxyconf ig -s 5 00:11:22:33:44:55:66:77, flOl 
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To remove device WWN 00:1 1 :22:33:44:55:66:77 from its persistent slot in fabric 5: 

fcr:admin> f crproxyconf ig -r 5 00:11:22:33:44:55:66:77 
WWN deleted from proxy device slot 

See also 

f crPhyDevShow 
f crProxyDevShow 
f crXlateConf ig 
IsanZoneShow 
switchShow 
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fcrProxyDevShow 



Displays MP Router proxy device information. 



Synopsis 

f crproxydevshow [-a all] [-f fabricid] [-w wwn] 

Availability 

all users 

Description 



This command displays the proxy devices presented by FCR EX_Ports and information about the proxy 



A proxy device is a virtual device presented to a fabric by an MP Router. A proxy device represents a real 
device on another edge fabric. When a proxy device is created in a fabric, the real device is considered 
to be imported into this fabric. The presence of a proxy device is required for interfabric device 
communication. The fabric sees the proxy device as a real Fibre Channel device. It has a name server 
entry and is assigned a valid port ID. 

Proxy device information is available only for proxy devices that are presented by MP Routers on the same 
backbone fabric as this MP Router. 

The default output displays only proxy device information relevant to this MP Router. Relevant proxy 
devices include proxy devices created by this MP Router (devices imported by this MP Router). 

The proxy devices are listed by fabric. The message No proxy device found is displayed if there is 
no proxy device information available at this MP Router. 

Each line of output displays the follov/ing information: 

Proxy Created in The fabric v/here the proxy device has been created. 



devices. 



Fabric 



WWN 



Device Exists in 
Fabric 



Physical PID 



Proxy PID 



The World Wide Name of the device port. 
The port ID of the proxy device. 

This port ID is relevant only on the fabric specified by the 

Proxy Created in Fabric column. 

The fabric v/here the real device represented by this proxy 
device exists. 



The port ID of the real/physical device. 



State 



This port ID is relevant only on the fabric specified by the 

Device Exists in Fabric column. 

Imported Proxy device has been imported into the 



fabric. 



Initializing 



The proxy device is being initialized and 
will soon be imported into the fabric. 
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Operands 

This command has the following optional operands: 

-a all Displays all proxy devices for all MP Routers in the same 

backbone fabric, whether or not they are relevant to this MP 
Router. 

-f fabric id Displays proxy devices in the specified fabric. 

-w wwn Displays proxy devices with the specified port WWN. 



Examples 

To display the proxy devices relevant to this MP Router: 



switch : admin> f crproxydevshow 










Proxy WWN 


Proxy 


Device 


Physical 


State 


Created 


PID 


Exists 


PID 




in Fabric 




in Fabric 






2 50:05:07:65:05:84:09:0e 


Olf 001 


3 


OlOOef 


Imported 


2 50:05:07:65:05:84:0b:83 


Olf 000 


3 


0100e8 


Imported 


3 10:00:00:00:c9:2b:6a:68 


02f000 


2 


C70000 


Imported 



See also 

f crFabricShow 
f crPhyDevShow 
f crRouteShow 
IsanZoneShow 
switchShow 
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fcrResourceShow 



Displays MP Router physical resource usage. 



Synopsis 



f crresourceshow 



Availability 

all users 

Description 

Use this command to display MP Router available resources. The maximum number allowed versus the 
number currently used is displayed for the various resources. 



The output is as follows: 

LSAN Zones 
LSAN Devices 

Proxy Device Slots 



Phantom Node WWN 



Phantom Port WWN 



Port Limits 



The maximum versus currently used LSAN zones. 

The maximum versus currently used LSAN device database 
entries. Each proxy or physical device constitutes an entry. 

The maximum versus currently used proxy device slots. A proxy 
device is presented to an edge fabric as being connected to a 
translate domain slot. A slot is the port number and AL PA 
combination. The slot-to-device WWN association is persistently 
stored. 

The maximum versus currently used phantom MP Router node 
WWNs. Phantom MP Routers require node WWNs for FSPF 
and manageability purposes. 

The maximum versus currently used phantom domain port 
WWNs. Phantom domain ports require port WWNs for 
manageability purposes. Phantom domain ports include ports 
connecting front and translate domains (virtual ISLs), translate 
domain ports for proxy devices, and EX Ports. 

Displays per-physical-port (EX_Port) resources: 

The maximum versus currently used 
proxy device entries. 

The maximum versus currently used 
NR_Port entries. Destination NR port 
entries are stored at every physical port 
for routing decisions. 

Currently 
Used (row 1: 
proxy, row2 : 
NR_Ports) : 



Max proxy 
devices 

Max NR Ports 



Operands 



none 
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Examples 

To display the resource usage for the local MP Router: 



f cr : adinin> f crresourceshow 












Daemon Limits : 
























T CAM "7 r^■n in o - 


1 n n n 
-L u u u 










LSAN Devices: 


10000 




14 






Proxy Device Slots: 


10000 




4 








WWN Pool size 




Allocated 






Phantom Node WWN: 


4096 




11 






Phantom Port WWN: 


16384 




37 






ir(_)-L U J_iJ_i[LJ_ L- o • 












Max proxy devices : 


2000 










Max NR_PortS : 


1000 










Currently Used (row 1 


: proxy, row2 : 


NR_Ports) : 






0 1 2 3 4 5 


6 7 8 


9 


10 11 12 


1314 


15 


0 2 0 2 0 0 


0 0 0 


0 


0 0 0 


00 


2 


0 3 0 3 0 0 


0 0 0 


0 


0 0 0 


00 


3 



See also 

f crFabricShow 
f crProxyDevShow 
f crRouteShow 
IsanZoneShow 
switchShow 
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fcrRouteShow 



Displays MP Router route information. 

Synopsis 

f crrouteshow 

Availability 

all users 

Description 

Use this command to display routes through the MP Router backbone fabric to accessible destination edge 
fabrics. 

An MP Router backbone fabric is the fabric that contains the E/F_Ports of this MP Router and routes 
interfabric traffic between edge fabrics, creating a meta-SAN. 

There are MP Router NR Ports that reside on the backbone fabric. MP Router NR Ports send/receive 
interfabric traffic. There is a one-to-one relationship between an NR Port on a backbone fabric and an 
EX Port. NR Port technology enables EX Ports to exchange traffic across an intermediate fabric. NR Ports 
are addressable entities on the backbone fabric and have port IDs relevant to the backbone fabric. 

Because this XPath OS release does not support cascaded backbone/intermediate fabrics, an NR Port 
provides a path to a single fabric with a single link cost. Multiple NR_Ports can provide paths to the same 
destination fabric. 

The message No routes found is displayed if there is no route information available at this MP Router. 
There will be no route information available if there are no EX_Ports configured at this MP Router. 

Each line of output displays the following information: 

Destination Fabric The destination fabric. 

ID 

NR_Port PID The port ID of the NR_Port. This port ID is relevant only on the 

backbone fabric. This NR Port has a route to the destination 
fabric identified by the Destination Fabric ID column. 

FCRP Cost The FCRP cost (for routing decisions) for this NR_Port. In this 

release, the FCRP cost is always the same (lOOO) for all 
NR_Ports. 

WWN of the The world wide name of the principal switch in the destination 

Principal Switch in fabric specified by the Destination Fabric ID column. This 
the Dest Fabric is useful for correlating the fabric ID listed in the Destination 

Fabric ID column with the actual fabric. 

Operands 

none 
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Examples 

To display the route information: 



switch : ad[nin> 


f crrouteshow 












Destination 


NR_Port 


FCRP Cost 




WWN of Principal 




Fabric Id 


PID 






Switch in the 














Dest. Fabric 






5 


650200 


1000 


10 : 


;00:00:60:69:90: 


;10 


:ba 


5 


650300 


1000 


10 : 


;00:00:60:69:90: 


;10 


:ba 


7 


660200 


1000 


10 : 


:00:00:60:69:c0; 


:6e 


: 84 


9 


660400 


1000 


10 : 


:00:00:60:69:10; 


:57 


:C3 



See also 

f crConf igure 
f crFabricShow 
f crPhyDevShow 
f crProxyDevShow 
f crXlateConf ig 
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fcrXlateConfig 

Displays or persistently configures a translate (xiate) domain's domain ID. 



Synopsis 

f crxlateconf ig [-r remove] edge Fabricldr emote Fabricldpref erred Domainid 



Availability 

admin 



Description 

Use this command to display a translate domain's domain ID or change the preferred domain ID. 

A translate domain is a phantom domain created by a Fibre Channel (FC) router. FC routers emulate 
proxy devices representing real devices in remote fabrics. These proxy devices are emulated to be 
connected to translate domains. Translate domains are presented to a fabric as residing topologically 
behind front phantom domains (domains created by an EX Port). In every EX Port-attached edge fabric, 
there can be a translate domain for every MP Router-accessible remote fabric. 

During a fabric build, the translate domain requests a domain ID from the principal MP Router in the 
EX Port-attached edge fabric. The domain ID requested is the preferred domain ID. The preferred domain 
ID can be set by a user v/hen the translate domain is not active and is persistently saved. The principal MP 
Router attempts to provide the translate domain with the requested domain ID but might not provide it if 
there are domain ID conflicts with other domains in the fabric. If the requested domain ID (for example, the 
preferred domain ID) is unavailable, the domain ID assignment is completely at the discretion of the 
principal MP Router. The assigned domain ID is persistently stored and is used as the preferred domain ID 
in the future. 



Operands 



This command had the following operands: 



-r remove 



edgeFabri aid 



remo t eFabri aid 



preferredDomainId 



Removes the configured domain ID (clears configured 
domain ID). The translate domain must be inactive to remove 
the preferred domain ID. 

Specifies the fabric ID of the fabric that contains the translate 
domain. Valid values are 1 to 12 8. 

Specifies the fabric ID of the remote fabric represented by this 
translate domain. Valid values are 1 to 12 8. 

Specifies the preferred domain ID of the translate phantom. 
Valid values are 1 to 2 3 9. 



Examples 

To display the translate domain configuration: 



f cr : admin> 


f crxlateconf ig 














EdgeFid 


RemoteFid 


Domain 


OwnerDid 






XlateWWN 






002 


003 


001 


N/A 






N/A 






004 


005 


002 


009 50 


00 


51 


el:30:30 


Of 


05 


005 


004 


003 


015 50 


00 


51 


el:30:30 


Of 


04 
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To set the preferred domain ID of the translate domain created in fabric 2 that represents remote fabric 3 
to a value of 1 : 

switch : adinin> f crxlateconf ig 2 3 1 
xlate domain already configured, overwrite? (y) y 
2 3 1 

To clear the preferred domain ID of the translate domain created in fabric 2 that represents remote fabric 
3: 

switch : adinin> f crxlateconf ig -r 2 3 
xlate domain deleted 

See also 

portCfgEXPort 

portDisable 

portEnable 

portShow 

portStart 

portStop 
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firmwareCommit 

Commits the current firmware image to the alternate bank. 

Synopsis 

f i r mwa r e c oinin i t 

Availability 

admin 

Description 

Use this command to commit (copy) the current firmware image from the primary partition to the 
secondary partition. 

To maintain the integrity of the firmware image in the flash memory, the f irmwareDownload command 
initially updates only the secondary partition. When the download completes successfully and the system 
reboots, the system swaps the partitions so that the primary partition (with the old firmware) becomes the 
secondary, and the secondary partition (with the new firmware) becomes the primary. 

By default, the f irmwareDownload command automatically copies the new firmware to the secondary 
partition after the reboot. If you decide to disable the autocommit (-n) option when running 
f irmwareDownload after the system is rebooted, you must execute the firmwareCommit command. 
firmwareCommit copies the primary partition (with new firmware) to the secondary partition, thereby 
committing the new firmware to both partitions of the system. 

Operands 

none 

Examples 

To commit a version of the firmware: 

switch : admin> f irmwarecoinmit 

See also 

altBoot 

f irmwareDownload 
f irmwareShow 
version 
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f i rmwa reDown load 



Downloads MP Router software from an FTP server. 



Synopsis 

f irmwaredownload -b -n hostlpAddr userName pfile password 



Availability 

admin 

Description 

Use thiis command to download and install the MP Router software from a remote FTP server to the 
platform's nonvolatile storage banks in a single step. 

The new firmware is in the form of RPM packages with names defined in pfile, a binary file that contains 
specific firmware information (time stamp, platform code, version, and so forth) and the names of 
packages of the firmware to be downloaded. These packages are made available periodically to add 
features or to remedy defects. Contact customer support to obtain information about available firmware 
versions. 

All systems supported by this firmware have two partitions of nonvolatile storage areas, a primary and a 
secondary, to store two firmware images, f irmwareDownload always loads the new image into the 
secondary partition and swaps the secondary partition to be the primary. When -b is specified, the 
command reboots the system and activates the new image. Finally, it performs the f irmwareCommit 
procedure automatically, to copy the new image to the other partition, unless -n is used. 

The command supports both noninteractive and interactive modes. If it is invoked without any command 
line parameters, or if there is any syntax error in the parameters, the command goes into interactive mode 
for downloading the main Fabric OS firmware. 

The f irmwareDownload command might fail for any of the following reasons: 

• The host is not known to the MP Router. 

• The host cannot be reached by the MP Router. 

• The FTP user name or password is incorrect. 

• pfile does not have the correct file permissions. 

• pfile does not exist on the host. 

• pfile is not in the correct format. 

• The package specified in pfile does not exist. 

• The FTP server is not running on the host. 

• Another f irmwareDownload session is running. 

Operands 

This command has the following required operands: 

hostlpAddr A valid FTP server IP address from which pfile is downloaded, 

for example, citadel or 192 . 168 . 166.30. The pfile 
downloads from this host. 

userName A valid user name for FTP access to the host, for example, 

jdoe. Uses the user name to access the host. 
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pfile A fully qualified path and file name for the firmware package 

list, for example, /v7 . 4 . 0 /release .plist. Absolute path 
names can be specified using forward slashes ( / ). 

password The password for userName. 

-b Activates autoreboot mode. After downloading firmware, the 

system must be rebooted for the new firmware to become 
active. When this operand is not specified, you must issue the 
reboot command to activate the download image. If 
autoreboot mode is enabled, the system reboots automatically 
after this firmware download completes successfully. 

-n Deactivates autocommit mode. By default, after running this 

command and after the reboot (either manual or autoreboot), 
the switch performs a f irmwareCommit command 
automatically. When autocommit is disabled, you need to 
issue f irmwareCommit to replicate the downloaded image 
to both partitions of the system. 

-i -s -t Provided for Fabric OS compatibility only. 

Examples 

To download and install an XPath base OS package from host 192.168.166.30 using account johndoe, 
password 12345, and pfile /usr/tmp2/ firmware: 



switch : adinin> f irmwaredownload 192.168.165.30 johndoe /usr/tmp2 / firmware 12345 



See also 

altBoot 

f irmwareCommit 
f spf Show 
version 
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firmwareShow 



Displays the versions on all firmware partitions in the system. 

Synopsis 

f irmwareshow 

Availability 

admin 

Description 

Use this command to display the firmware versions on the primary and secondary partitions. 

Operands 

none 

Examples 

switch : adinin> f irmwareshow 

=========================== Active (Bank 2) Version 

Installed Packages: 

Package Name: xpath_os_v7 . 4 . 0_prealphal_bldl7 

Install Date: Apr 14, 2005 18:48 



========================== Inactive (Bank 1) Version 

Installed Packages: 

Package Name: xpath_os_v7 . 4 . 0_prealphal_bldl7 

Install Date: Apr 14, 2005 18:48 



See also 

altBoot 



f irmwareCommit 
f irmwareDownload 
version 
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fspfShow 

Displays FSPF protocol information. 

Synopsis 

f spf show 

Availability 

all users 

Description 

Use this command to display the Fibre Channel Shortest Path First (FSPF) protocol information and some 
internal data structures. 

The command displays the following fields: 

Version The version of FSPF protocol 

Domain ID The domain number of the local MP Router 

ISL_P0RT BIT MAP The bit map of all the E_Ports 

minLSArrival FSPF constant 

minLSInterval FSPF constant 

startTime The start time of FSPF since boot 

Operands 

none 

Examples 

To display FSPF protocol information: 



switch : admin> f spf show 






Version = 2 






Domain ID =100 






isl_ports bitmap [0- 


15] = 


0x7873 


minLSArrival = 1 






minLSInterval = 5 






StartTime = Thu Aug 


21 10 


41:42 2003 



See also 

f abricShow 

topologyShow 

urouteShow 
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Displays the most recent 20 commands executed. 

Synopsis 

h 

Availability 

all users 

Description 

Use this command to display the most recent 20 commands executed. 

Operands 

none 

Examples 

To display the history of commands executed: 

switch : adinin> h 

See also 

none 
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help 

Displays the manual (man) page of a command. 

Synopsis 

help [ "command"] 

Availability 

all users 

Description 

Use this command without a parameter to display an alphabetical list of commands for which help is 
available. With a parameter, the command displays the man page of the specified command. If no help is 
available for the command, a message that states there is no help for the command appears. 

Operands 

This command has the following optional operand: 

"command" The command for which help is required, with or 

without quotes. 

Examples 

To display the man page of chassisShow: 
switch : admin> help chassisshow 

See also 

none 
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ifcsDisable 



Disables the IP storage fabric configuration server (iFCS) function in the fabric. 



Synopsis 

if csdisable 

Availability 

admin 

Description 

Use this command to disable the iFCS function in the fabric and place all IP-aware routers currently in 
primary and secondary mode in stand-alone mode. 



\^^}f NOTE: Issue this command from the primary iFCS only. 




Operands 



none 



Examples 



To disable the iFCS function: 



switch : adinin> ifcsdisable 



Starting ifcsdisable 



ifcsdisable completed successfully 



See also 



if csEnable 



if csShow 
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ifcsEnable 

Enables the IP storage fabric configuration server (iFCS) function in the fabric by making the MP Router the 
primary iFCS MP Router. 

Synopsis 

if csenable 

Availability 

admin 

Description 

Use this command to enable the iFCS function by selecting this MP Router to be the primary iFCS and 
making the remaining IP-aware MP Routers to be secondary. The primary iFCS then performs a two-way 
merge of its existing configuration with all of the secondary MP Routers in the fabric and continues to do 
so whenever there is a change in any IP storage configuration. 

A secondary MP Router automatically becomes the primary if the current primary is removed from the 
fabric. When this occurs, the primary selection is based on the second and third least-significant bytes of 
the MP Router WWN. The secondary MP Router in the fabric with the larger value of those two bytes 
becomes the primary. For example, a secondary with a WWN of 1 0:00:00:05: le:l 5:84:00 becomes 
primary over another secondary with a WWN of 1 0:00:00:05: 1 e: 1 2:de:00 because 0x1 584 is larger 
than 0x1 2de. 

The iFCS function distributes the IQN-to-WWN mapping of each iSCSI host and their shared Challenge 
Handshake Authentication Protocol (CHAP) secret configuration to all IP storage-aware routers in the 
fabric. This distribution enables iSCSI hosts to move from one MP Router to another MP Router within a 
fabric. 

iFCS is disabled by default. 

Operands 

none 

Examples 

To enable the iFCS function: 

switch : admin> ifcsenabie 
Starting ifcsenabie 



ifcsenabie completed successfully 

See also 

if csDisable 
if csShow 
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ifcsShow 

Displays the status of all IP storage fabric configuration server (iFCS) routers in the fabric. 

Synopsis 

if csshow 

Availability 

all users 

Description 

Use this command to display the current status of all iFCS and IP-aware routers in the fabric. 

Operands 

none 

Examples 

To display the current status of all iFCS routers in the fabric: 



switch 


adinin> ifcsshow 








WWN 


IP Address 


Status 


10 


00:Q0:05:le:15:84:00 


10 . 32 . 154 . 190 


PRIMARY 


10 


00:00:05:le:12:de:00 


10 . 32 . 154 . 112 


SECONDARY 


10 


00:00:05:le:13:70:00 


10 .32 . 154 . 18 


SECONDARY 



See also 

if csDisable 
if csEnable 
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ifModeShow 

Displays the operation mode for a management Ethernet interface. 

Synopsis 

ifmodeshow [mgmtPortNum] 

Availability 

all users 

Description 

Use this command to display the operation mode for a management Ethernet interface. 

Operands 

The following operand is optional: 

mgmtPortNum Specifies the port number of the management Ethernet interface. 

Examples 

To display the operation mode for management Ethernet interface 1 : 



switch : admin> ifmodeshow 1 




Management ethernet interface 


configuration 


MGMT 1: Configuration 


Current 


Mode auto 


lOOmfd 


MAC Address 


00:05:le:31:25:10 



To display the operation mode for all management Ethernet interfaces: 



switch : admin> ifmodeshow 








Management 


ethernet interface 


configuration 






MGMT 1 : 
Mode 

MAC Address 


Configuration 
auto 


Current 

lOOmfd 

00:05:le:31 


25 


10 


MGMT 2 : 
Mode 

MAC Address 


Configuration 
auto 


Current 

lOOmfd 

00:05:le:31 


25 


11 



See also 

none 
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interfaceShow 



Displays FSPF interface information. 



Synopsis 



interf aceshow [port] 



Availability 

all users 

Description 

Use thiis command to display all the data structures associated with one or all the FSPF interfaces on the 
MP Router. An FSPF interface corresponds to an E Port. 

If no arguments are specified, this command displays the interface information for all E_Ports. 
The following fields appear: 



LocalPortId 
def aultCost 

cost 

delay 

upCount 

lastUpTime 

downCount 

lastDownTime 

state 

lastTransition 

nghbid 
remPort 
nf lags 
initCount 

lastlnit 

inactivity time out 
value 

hello time out value 
rXmit time out value 



The local port ID. 

The default cost of sending a frame over the ISL connected to this 
interface. A value of 5 00 indicates a 2-Gb/s link. 

The actual cost of sending a frame over the ISL connected to this 
interface. 

The conventional delay incurred by a frame transmitted on this ISL. 
It is required by the FSPF protocol, and it is a fixed value. 

The number of times this interface came up, with respect to FSPF. 

The last time this interface came up. 

The number of times this interface went down. 

The last time this interface went down. 

The current state of this neighbor (adjacent) MP Router or switch. 
This E_Port is used to route traffic to other MP Routers or switches 
only if the state is nb_st_full. 

The time of the last state transition of the neighbor finite state 
machine. 

The domain ID of the neighbor switch. 

The port number on the remote switch connected to this port. 
Internal FSPF flags. 

The number of times this neighbor was initialized without the 
interface going down. 

The time of the last neighbor initialization. 

The inactivity timeout value, in milliseconds. When this timeout 
expires, the adjacency with the neighbor MP Router or switch is 
considered broken. When this happens, new paths are computed 
to all the possible destination MP Routers or switches in the fabric. 

The Hello timeout value, in milliseconds. When this timeout 
expires, a Hello frame is sent to the neighbor MP Router or switch 
through this port. 

The retransmission timeout value, in milliseconds, which is used to 
reliably transmit topology information to the neighbor MP Router 
or switch. If the topology information is not received within the 
specified time, a frame is retransmitted. 
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No. of commands accepted 



No. of invalid cmds 
received 



No. of hello received 

No. of LSUs received 

No. of LSAs received 

No. of Helios xmit 
attempted 

No. of Helios 
transmitted 

No. of LSUs transmit 
attempted 

No. of LSUs transmitted 

No. of LSAs transmit 
attempted 

No. of LSAs transmitted 



The total number of commands accepted from the neighbor 
MP Router or switch. It includes Helios, Link State Updates (LSUs), 
and Link State Acknowledgements (LSAs). 

The number of invalid commands received from the neighbor MP 
Router or switch. Typically, these are commands with an FSPF 
version number later than the one running on the local MP Router 
or switch. 

The number of Hello frames received from the neighbor MP Router 
or switch. 

The number of LSUs received from the neighbor MP Router or 
switch. 

The number of LSAs received from the neighbor MP Router or 
switch. 

The number of attempted transmissions of Hello frames to the 
neighbor MP Router or switch. 

The number of Hello frames transmitted to the neighbor MP Router 
or switch. 

The number of attempted transmissions of LSUs to the neighbor MP 
Router or switch. 

The number of LSUs transmitted to the neighbor MP Router or 
switch. 

The number of attempted transmissions of LSAs to the neighbor MP 
Router or switch. 

The number of LSAs transmitted to the neighbor MP Router or 
switch. 



Operands 

The following operand is optional: 

port Specifies the port number. 

Examples 

To display FSPF interface information for port 1 : 

switch: admin> interf aceshow 1 

Interface 1 data structure: 

LocalPortId 
def aultCost 
cost 
delay 
upCount 
lastUpTime 
downCount 
lastDownTime 



= 1 
= 500 
= 500 
= 1 
= 1 

= Tue Jul 6 17:28:51 UTC 2004 
= 0 
= 0 



(continued on next page) 
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Neighbor 1 data structure: 



state = NB_ST_FULL 

lastTransition = Tue Jul 6 17:28:51 UTC 2004 

nghbid = 1 

remPort = 1 

nflags = 3 

initCount = 1 

lastlnit = Tue Jul 6 17:28:51 UTC 2004 

inactivity time out value = 80 

hello time out value = 20 

rXmit time out value = 5 



No. 


of 


commands accepted 


= 26 


No. 


of 


invalid cmds received 


= 0 


No. 


of 


hello received 


= 25 


No. 


of 


LSUs received 


= 5 


No. 


of 


LSAs received 


= 5 


No. 


of 


Helios xmit attempted 


= 25 


No. 


of 


Helios transmitted 


= 25 


No. 


of 


LSUs transmit attempted 


= 4 


No. 


of 


LSUs transmitted 


= 4 


No. 


of 


LSAs transmit attempted 


= 5 


No. 


of 


LSAs transmitted 


= 5 



See also 

linkCost 
nbrStateShow 
portShow 
switchShow 
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iod Reset 

Turns off the in-order delivery option. 

Synopsis 

iodreset 

Availability 

admin 

Description 

Use this command to allow out-of-order delivery of frames during fabric topology changes. 
This is the default behavior, because it allov/s fast rerouting after a fabric topology change. 

Operands 

none 

Examples 

To turn off the in-order delivery option: 

switch: admin> iodreset 

in-order delivery option cleared. 

See also 

dlsReset 

dlsSet 

dlsShow 

iodReset 

iodSet 

iodShow 

trunkReset 

trunkSet 

trunkShow 
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iodSet 

Turns on the in-order delivery option. 

Synopsis 

iodset 

Availability 

admin 

Description 

Use this command to enforce in-order delivery of frames during fabric topology changes. 

In a stable fabric, frames are alv/ays delivered in order, even v/hen the traffic betv/een MP Routers is 
shared among multiple paths. Hov/ever, v/hen a topology change occurs in the fabric (for instance, a link 
goes dov/n), traffic is rerouted around the failure. In general, it is possible that a frame, queued behind a 
congested link, v/ill be delivered after a frame that v/as transmitted later but is now taking the nev^ path. 

This command ensures that frames are delivered in order, even during fabric topology changes. 

The default behavior is for the in-order delivery option to be off. 

This command should be used with care, because it causes a delay in the establishment of a new path 
when a topology change occurs. This command should be used only if there are devices connected to the 
fabric that do not tolerate occasional out-of-order delivery of frames. 

Operands 

none 

Examples 

To turn on the in-order delivery option: 

switch : adinin> iodset 
in-order delivery option set. 



See also 

dlsReset 

dlsSet 

dlsShow 

iodReset 

iodShow 

trunkReset 

trunkSet 

trunkShow 
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iodShow 

Displays the state of the in-order delivery option. 

Synopsis 

iodshow 

Availability 

all users 

Description 

Use this command to determine whether in-order delivery during topology changes is on or off. 

Operands 

none 

Examples 

To display the state of the in-order delivery option: 

switch : admin> iodshow 
lOD is not set 

See also 

lodReset 
iodSet 
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ipaddrSet 

Sets the IP configuration for an Ethernet management interface. 

Synopsis 

ipaddrset mgmtPortNum -i ipAddress -n netMask -g gateway 
-a action [-s] [-r] 



Availability 

admin 

Description 

Use this command to set the IP configuration for an Ethernet management interface. 

Operands 

The following operands are required: 

mgmtPortNum Selects one of the two management Ethernet interfaces available 

on the front panel. 

-i ipAddress Specifies an Ethernet management port number of 1 or 2. 

-n netMask Sets the netmask, in the standard aa.bb.cc.dd format. 

-g gateway Sets the gateway, in the standard aa.bb.cc.dd format. 

-a action Specifies whether the change takes effect immediately (cf gnow) 

or after the next reboot (cf gaf terreboot). 

The following operands are optional: 

-s Specifies whether to set the MP Router virtual IP address and 

netmask to the same as the new IP address and netmask. 

-r Specifies whether to reset the IP configuration of the 

management interface. The -r operand is applicable to 
management interface 2 only. 



NOTE: If the secondary management interface is not used, the virtual management IP configuration 
changes along with the primary IP configuration. 



Examples 

To set IP address 192.168.10.1, netmask 255.255.255.0, and gateway 192.168.10.2 of management 
interface 1 : 

switch:admin> ipaddrset 1 -i 192.168.10.1 -n 255.255.255.0 -g 192.168.10.2 -a cfgnow 

To set the IP address 192.168.10.1, netmask 255.255.255.0, and gateway 192.168.10.2 of 
management interface 1, and set the MP Router virtual IP address and netmask: 

switch :adinin> ipaddrset 1 -i 192.168.10.1 -n 255.255.255.0 -g 192.168.10.2 -a cfgnow -s 
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To reset IP configuration of management interface 2 to factory defaults: 

switch :admin> ipaddrset 2 -r -a cf gaf terreboot 

See also 

ipaddrShow 

svipAddrSet 

svipAddrShow 
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ipaddrShow 

Displays the Ethernet management interface IP configuration. 

Synopsis 

ipaddrshow [mgmtPortNum] 

Availability 

all users 

Description 

Use this command to display the IP configuration for one or all Ethernet management interfaces. 

Operands 

The following operand is optional: 

mgmtPortNum Specifies the management Ethernet port number. 

Examples 

To display the IP configuration of Ethernet management interface 1 : 



switch : adinin> 


ipaddrshow 1 






MGMT 1 


Configuration 


Current 




IP Address 


10.33.58.20 


10.33 .5f 


3.20 


Net Mask 


255.255. 224 . 0 


255 .255 


224 . 0 


Gateway 


10.33.48.1 


10.33.4E 


3.1 


To display the IP configuration of all Ethernet interfaces: 


switch : admin> 


ipaddrshow 






MGMT 1 


Configuration 


Current 




IP Address 


10.33.58.20 


10.33.5E 


3.20 


Net Mask 


255.255.224.0 


255 .255 


224 . 0 


Gateway 


10.33.48.1 


10.33 .4f 


3.1 


MGMT 2 


Configuration 


Current 




IP Address 


0.0.0.0 


0.0.0.0 




Net Mask 


0.0.0.0 


0.0.0.0 




Gateway 


0.0.0.0 


0.0.0.0 





See also 

ipaddrSet 
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iscsiAuthCfg 

Displays and configures the iSCSI authentication database. 

Synopsis 

iscsiauthcfg [-i iSCSI_IQN -c iSCSI_CHAP_Secret] [-d iSCSI_IQN 
[ - c i SCSI_CHAP_Secre t ] ] 

Availability 

admin 

Description 

Use this command to display and configure the iSCSI authentication database. To display the database, 
execute iscsiAuthCfg without operands. If the same iSCSI qualified name (IQN) maps to two different 
CHAP secrets, the status of the entry is displayed as Conflict. Use -d to delete the CHAP secret from a 
known IQN. Use -i and -c to set a CHAP secret for a known IQN. 

Use the if csShow command to query the iFCS status. 

Operands 

The following operands are optional: 

-i and -c Sets a CHAP secret for an IQN. 

-d Deletes the CHAP secret from an IQN. This operand can be used 

only on the IP storage fabric configuration server (iFCS) primary 
MP Router if iFCS is enabled. 

Examples 

To add a CHAP secret for an IQN ( iqn . 1991-05 . com. microsoft : cp0822 07 ) : 

switch : admin> iscsiauthcfg -i iqn. 1991-05 . com. microsoft : cp082207 -c abcdefgl23 
Create [iqn . 1991-05 . com. microsoft : cp082207 , abcdefgl23] successful. 



To display CHAP secrets: 



switch 


admin> iscsiauthcfg 






Index 


iSCSI Name 


iSCSI CHAP 


Status 


1 


iqn. 1991-05 .com.microsoft: cp0822 07 




Normal 



To delete a CHAP secret for an IQN ( iqn. 1991-05 . com.microsoft : cp0822 07): 

switch : admin> iscsiauthcfg -d iqn. 1991-05 . com.microsoft : cp082207 
Delete [iqn . 1991-05 . com.microsoft : cp082207 ] successful. 



See also 

if csShow 



iscsiWwnAlloc 
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iscsiFailoverAdd 

Adds a failover world wide name (WWN) for the local MP Router. 

Synopsis 

iscsif ailoveradd failover-swi tch-wwn 

Availability 

admin 

Description 

Use this command to add a failover MP Router. The IP storage fabric configuration server (iFCS) function 
must be enabled so that the high availability (HA) function works appropriately. 

Operands 

The following operand is required: 

failover-switch-wwn Specifies the WWN of the failover MP Router. 

Examples 

To add a failover MP Router whose WWN is 1 0:00:00:05: le: 13:36:00: 

switch : adinin> iscsif ailoveradd 10 : 00 : 00 : 05 : le : 13 : 36 : 00 
The failover switch is added 



See also 

if csDisable 
if csEnable 
if csShow 

iscslFailoverDelete 
iscsiShow 
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iscsiFailoverDelete 

Deletes a previously configured fciiover MP Router. 

Synopsis 

iscsif ailoverdelete 

Availability 

admin 

Description 

Use this command to remove a previously configured failover MP Router. 

Operands 

none 

Examples 

To remove a previously configured failover MP Router: 

switch : admin> iscsif ailoverdelete 
The failover switch is deleted 



See also 

iscslFai lover Add 
iscsiShow 
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iscsiPortShow 

Displays iSCSI sessions and port counters on the specified portal. 

Synopsis 

iscsiportshow port [-r] 

Availability 

all users 

Description 

Use this command to display all the iSCSI sessions in the system and the counters of an iSCSI port. 

Operands 

This command has the following operands: 

port Identifies the port, (required) 

-r Resets the counter, (optional) 

Examples 

To display information about iSCSI port 1 2: 



switch : admin> iscsiportshow 12 


Total # active iSCSI session: 1 


Session # 1: 




Session ID 


: 0x40 00 01 37 00 9b 


Initiator 


: iqn. 1991-05 . com. microsoft : isil54110 at 192.168.2 50.110 


Initiator DAP 


: 0x640700 


Target 


: iqn. 2 002-12 . com. brocade : 21000004cf 2 0ab8a 


Target DAP 


: 0x6408ce 


TSID 


: 0x705 


Port statistics: 




iSCSI In PDU 


: 20 


iSCSI In Octet 


: 976 


iSCSI Out PDU 


: 37 


iSCSI Out Octet 


: 63967 


FC In PDU 


: 35 


FC In Octet 


: 4008 


FC Out PDU 


: 18 


FC Out Octet 


: 0 


iSCSI Cmd 


: 18 


(continued on next 


page) 
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iSCSI 


Data Out 


u 


iSCSI 


Data In 




FC R2T 


n 
u 


FC RSP 


-L O 


iSCSI 


Error PDU 


u 


FC Error PDU 


n 
u 


iSCSI 


SNACK 


n 
u 


iSCSI 


NOP OUT 


n 

u 


iSCSI 


Text 


-1 
J. 


iSCSI 


Logout 


1 


iSCSI 


Abort Tsk 


0 


iSCSI 


Task Mgmt 


0 



See also 

portCf gGige 
portShow 
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iscsiShow 

Displays an overview of the iSCSI status on the MP Router. 

Synopsis 

iscsishow 

Availability 

all users 

Description 

Use this command to display an overview of the iSCSI status on the MP Router. The display includes the 
number of each of the following: 

• MP Router portals that are currently iSCSI portals 

• iSCSI sessions across all those portals 

• iSCSI initiators currently in session with the FC storage 

• FC targets that are currently used by all the initiators across all the portals 

Also, it provides a count of errors and other HA configuration parameters. The HA MP Router is indicated 
if it is in fabric. 

Operands 

none 

Examples 

To display information about iSCSI status on the MP Router: 



switch :adinin> iscsishow 




IPCS Status: 




PRIMARY 


IP Address 


of Primary: 


10 . 32 . 154 . 18 


WWN of HA 


Switch: 


10:00:00:05:le:15:a9:00 


(in the fabric) 






Number of 


iSCSI 


Portals : 


1 


Number of 


iSCSI 


Target Nodes : 


5 


Number of 


iSCSI 


Initiator Nodes: 


20 


Number of 


iSCSI 


Login Failures: 


2 


Number of 


iSCSI 


Authentication Failures: 


7 


Number of 


iSCSI 


Session Aborts: 


1 



See also 

iscsi Port Show 
portShow 
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iscsiWwnAlloc 



Displays and configures the IQN-to-WWN mapping database. 

Synopsis 

iscsiwwnalloc [-i iSCSI_IQN [-n node_WWN -p port_WWN] ] 
[ -d iSCSI_IQN [ -n node_WWN] ] [ -v] 

Availability 

admin 

Description 

Use this command to display and configure the IQN-to-WWN mapping database. To display the 
database, execute iscsiWwnAlloc without operands. If the same IQN maps to two different node 
WWNs, the status of the entry is displayed as Conflict. If the same initiator has both IQN and IP 
addresses mapping to two different node WWNs, the entry status displays as Multiple. 

Attempts to delete a mapping fail if the iSCSI initiator is currently registered with the Name Server. Use -f 
to delete the mapping entry irrespective of the initiator's Name Server registration status. 

In an iFCS function-enabled fabric, only the primary PCS allows for manual WWN allocation and 
deletion. The command fails if there are connectivity problems between the primary and secondary PCS 
and if the WWN entry is associated with zoning. You must fix the connectivity problems and clean up the 
zoning configuration before deleting a WWN entry. 

Operands 

This command has the following operands: 

-i Preallocates a node and a port WWN for a given IQN. Both node 

and port WWNs are generated dynamically. 

-n Specifies a specific node WWN. 

-p Specifies a specific port WWN. 

-d Removes an IQN-to-WWN mapping entry. 

-n Specifies a specific node if there are conflicts in 

the WWN mapping table. 

-f Deletes the mapping entry irrespective of the 

initiator's Name Server registration status. 

-V Displays zoning entries associated with the IQN. 

Examples 

To add node and port WWNs for a given IQN (iqn. 1991 -05.com. microsoft:cp082207): 

switch : admin> iscsiwwnalloc -i iqn . 1991-05 . com. microsoft : cp0822 07 
Create iqn. 1991-05 . com. microsoft : cp082207 successful. 
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To display the IQN-to-WWN mapping database: 



switch : adinin> iscsiwwnalloc 




1 IQN: 


iqn. 1991-05 . com. microsoft : cpOf 


32207 


Node WWN: 


56:00:51:el:33:60:00:02 




Port WWN: 


57:00:51:el:33:60:00:02 




Status : Normal 




switch : ac3inin> iscsiwwnalloc -v 




1 IQN: 


iqn. 1991-05 . com. microsoft : cpOf 


B22 07 


Node WWN: 


56:00:51:el:33:60:00:02 




Port WWN: 


57:00:51:el:33:60:00:02 




Status: Normal (no zone configuration) 





To delete the iqn. 1 991 ■O5.com.microsoft:cp082207 entry: 



switch ; admin> iscsiwwnalloc -d iqn. 1991-05 . com. microsoft : cp082207 
Delete iqn. 1991-05 . com. microsoft : cp082207 successful. 

See also 

IscsiAuthCf g 
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licenseAdd 

Adds a license key to the system. 

Synopsis 

licenseadd " licensekey" 

Availability 

admin 

Description 

Some features of the system and of the fabric to which it is connected are optional, licensed products. 
Without a license installed, the services will not function. 

Use this command to add a license to the system. A license key is a string of approximately 16 uppercase 
and lowercase letters and digits. Case is significant. The key is an encrypted form of the system WWN 
and the products licensed to run on this system. 

The license key must be entered into the system exactly as issued. If entered incorrectly, the license key 
might be accepted, but licensed products will not function. After entering the license key, use the 
licenseShow command to check for correct function. If no licensed products are displayed, the license 
key is invalid. 

After entering a valid license key, the licensed product is available immediately; you do not need to reboot 
the system. 

Operands 

The following operand is required: 

"licensekey" Specify the license key, with or without quotation marks. 

Examples 

To add a license to the system: 

switch : admin> licenseadd "bQebzbRdScRf cOiK" 
License key bQebzbRdScRf cOiK added 

See also 

licenseRemove 
licenseShow 
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licenseRemove 



Removes a license from this system. 

Synopsis 

licenseremove " licensekey" 

Availability 

admin 

Description 

Some features of the system and of the fabric to which it is connected are optional, licensed products. 
Without a license, the services v/ill not function. 

Use this command to remove an existing license key from the system. The existing license key must be 
entered as an operand exactly as shown by licenseShow, including case. 

Operands 

The following operand is required: 

"licensekey" Specify the license key, in quotation marks. 

Examples 

To remove a license from the system: 

switch : adinin> licenseremove "bQebzbRdScRf cOiK" 
removing license key "bQebzbRdScRf cOiK" 

See also 

licenseAdd 
licenseShow 
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licenseShow 

Displays installed licenses. 

Synopsis 

licenseshow 

Availability 

all users 

Description 

Some features of the system and of the fabric to which it is connected are optional, licensed products. 
Without a license, the products will not function. 

Use this command to display the current, installed licenses and a list of the licensed products that are 
enabled by these license keys. 

A license key is a string of approximately 16 uppercase and lowercase letters and digits. Case is 
significant. The key is an encrypted form of the system WWN and the products licensed to run on this 
system. 

Operands 

none 

Examples 

To display the current licenses: 



switch : ac3min> licenseshow 


License Key: 


yzSyyeQySzOTzzF 




Web 


License Key: 


R9SbzQyczcSATc0u 




Zoning 


License Key: 


S z c S 9 yReyyT 0 dTAM 




Base switch license 


License Key: 


ReyQScc9czaf zRTl 




Trunking 


License Key: 


ReyQScc9czSnzRTl 




FCIP 


License Key: 


ReyQScc9czSflRTv 




Fibre Channel Routing Services 


License Key: 


ReyQScc9czSvzRT9 




Ports on Demand - enable all 16 ports 
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See also 

licenseAdd 
licenseRemove 
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linkCost 

Displays or sets the configured port link cost. 

Synopsis 

linkcost port [linkcost] 



Availability 

admin 



Description 

Use this command to display or set the cost of an interswitch link (ISL). The cost of a link is a dimensionless 
positive number. It is used by the FSPF path selection protocol to determine the least-costly path for a frame 
from the source to the destination MP Router or switch. The cost of a path is the sum of the costs of all the 
ISLs traversed by that path, also knov/n as the metric. 

FSPF supports load sharing over a number of equal-cost paths. 

Every ISL has a default cost that is inversely proportional to the bandv/idth of the Gb/s ISL. For a 1-Gb/s 
ISL, the link cost is 1,000; for a 2-Gb/s ISL, the link cost is 500. 



Operands 

Without operands, this command displays the actual link cost of all the links. All currently active ISLs have 
an additional suffix of E_Port attached to their interface numbers. If the link has a static cost assigned to 
it, the link cost for that link has a suffix of STATIC. 

With one operand (port), this command displays the actual cost of a specific link. With the two 
operands (port and linkcost), it sets the cost of a specific link. Setting the cost to 0 removes a static 
cost from the database and reverts to the current operational port link cost. 

Examples 

To display the fixed link cost of port 3: 

switch : admin> iinkcost 3 

port 3 linkcost is: 1000 (STATIC) 

To set the link cost of port 5 to the default: 

switch : admin> linkcost 5 0 

port 1 linkcost is set to: AUTO 
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To display the link cost of all ports: 



switch : adinin> 


linkcost 


Interface 


Cost 


0 


500 


1 


2 000 (STATIC) 


2 


500 


3 


500 


4 (VE_PORT) 


4000 


5 


500 


6 (ISCSI) 


N/A 


7 


500 


8 


500 


9 


500 


10 


500 


11 (VE_PORT) 


1800 (STATIC) 


12 


500 


13 


500 


14 


500 


15 


500 



To set the link cost of port 1 to 1 000: 



switch : ad[nin> linkcost 1 1000 
port 1 linkcost is set to: 1000 



To set the link cost of ports 6 through 8 to 2000: 



switch 


adinin> linkcost 


6-8 


2000 


port 6 


linkcost is set 


to: 


2000 


port 7 


linkcost is set 


to: 


2000 


port 8 


linkcost is set 


to: 


2000 



See also 

portCf gTopology 

portDisable 

portEnable 

portShow 

portType 
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IsanZoneShow 

Displays LSAN zone information. 

Synopsis 

Isanzoneshow [-s ] [-f fabricID] [-m wwn] [-z zonename] 

Availability 

all users 



Description 

This command displays the LSAN zones. The LSAN zones are normal WWN zones created in MP Router 
EX Port-connected edge fabrics. The LSAN zones are identified by the case-insensitive text string "LSAN " 
in the zone name and contain only port WWNs. The MP Router uses these zones to establish the 
interfabric device sharing policy. The LSAN zones are established by zoning administration in each 
EX_Port-attached edge fabric. Interfabric device sharing is allov/ed betv/een tv/o or more devices if the 
LSAN zones defined in their respective edge fabrics both allov^ the tv/o devices to communicate (such that 
the intersection of LSAN zones in two edge fabrics define the interfabric device sharing policy). 

The LSAN zones are listed by fabric. LSAN zone membership information (information about the devices in 
the LSAN zone) is provided for each LSAN zone. The default output displays only port v/orld wide names 
of the LSAN zone members. 

The message No LSAN zone found is displayed if there is no LSAN zone information available at this 
MP Router. 

Each LSAN zone entry displays the following output: 

Fabric ID The fabric on which the LSAN zone has been created. 

Zone Name The zone name. 

A list of zone members The zone members or devices. The default output displays the 

WWN of the zone members. 



Operands 



This command has the following optional operands: 



-f fabricID 



-z zonename 



Displays state information for the device. Valid states include: 

Device exists in this fabric (the fabric of the 
LSAN zone entry). 

Device has been imported (proxy created) into 
this fabric. 



Exist 
Imported 
Configured 



Device is configured to be in an LSAN, but the 
device is not imported and does not exist in this 
fabric. 

Specifies a search parameter that returns LSAN zones for the 
specified fabric. 

Specifies a search parameter that displays LSAN zones containing 
the specified port WWN. 

Specifies a search parameter that displays LSAN zones with the 
specified zone name. 
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Examples 

To display the LSAN zones: 



switch : adinin> Isanzoneshow 



Fabric 


ID: 


4 Zone Name 


lsan_ 


_fcrlO_ 


_0 




50 


05:07:65:05 


84:0b 


83 






50 


05:07:65:05 


84:09 


Oe 






1 n 
-L U 


UU:UU:Uu:Cy 


ZD : OB. 


o o 






21 


00:00:20:37 


18 : 22 


55 




Fabric 


ID: 


5 Zone Name 


lsan_ 


_fcrll_ 


_0 




10 


00:00:00:c9 


2b: 6a 


68 






21 


00:00:20:37 


18 : 22 


55 






50 


05:07:65:05 


84:0b 


83 






50 


05:07:65:05 


84:09 


Oe 





See also 

f crFabricShow 
f crPhyDevShow 
f crProxyDevShow 
f crRouteShow 
switchShow 
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IsdbShow 



Displays the FSPF Link State Database. 



Synopsis 



Isdbshow [doniain_number] 



Availability 

all users 



Description 

Use this command to display a Link State Database Record for either one or all the MP Routers or switches 
in the fabric. 

The MP Router connects to the fabric when two data structures are involved: the Link State Database Entry 
and a Link State Record (LSR). The LSR for domain n describes all the links that the MP Router with domain 
number n has with all its neighbor routers or switches. For a link to be reported in the LSR, the neighbor for 
that link must be the NB_ST_FULL state. 

This command displays the content of both data structures, if the LSR is present, as follows: 

The domain number described by this LSR. 
Number of timers running. 
Internal variable. 

Number of link state acknowledgements pending. 
The ports on which the LSAs are expected. 

Switch Link Record or AR Summary Record type. 

The age, in seconds, of this LSR. An LSR is removed from the 
database when its age exceeds 3,600 seconds. 



Domain 

Timers Running 
flags 

numLSAs Pending 

f loodlist 

Link Record type 

Age of this record 
in seconds 

Domain id of switch 
owning this record 

Domain id of the 
switch advertising 
the LSR 

LSIncarnationNum 

checksum 

LSRLength 

Num Links 
Linkid 

out port 
rem port 
cost 



The incarnation number of this LSR. 

The checksum of the whole LSR, except the IsAge field. 

The total length (in bytes) of this LSR. The length includes the 
header and the link state information for all the links. 

The number of links to the domain. 

The ID of this link. The ID is the domain number of the MP Router 
or switch on the other side of the link. 

The port number on the local MP Router. 

The port number of the port on the other side of the link. 

The actual cost of this link. 



Operands 



The following operand is optional: 
domain_number The domain number of the LSR to display. 
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Examples 

To display the LSR owned by domain 58: 



switch ; ac3iriin> Isdbshow 58 




Domain = 58 




Timers Running = 0 




flags = 0 




numLSAsPending = 0 




floodlist = 0000000000000000000000000000000000000000 




Link Record type is Switch Link Record 








Domain id of switch owning this record = 58 




Domain id of the switch advertising the LSR = 58 




LSIncarnationNum = 0x800003d0 




checksum = 0x6a50 




LSRLength =44 




Num Links = 1 




Link Id = 71 out port = 1 rem port = 15 link cost = 500 type = 


= 1 



See also 

f abricShow 
interf aceShow 
nbrStateShow 
topologyShow 
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nbrStateShow 



Displays the FSPF state of the neighbor. 



Synopsis 



nbrstateshow [port] 



Availability 

all users 

Description 

Use this command to display a synopsis of all the neighbors of the local MP Router or of a specific 
neighbor if a parameter is supplied. 

A neighbor is a switch or another MP Router that is attached directly to the local MP Router. 

The following fields are displayed: 

Local Domain Id The domain number of the local MP Router. 

The E_Port (interface) on the local MP Router. 
The domain number of the remote MP Router or switch. 
The E Port (interface) on the remote MP Router or switch. 
The state of the neighbor. The E Port is used to route frames only if the 



Local Port 
Domain 
Remote Port 
state 



neighbor is in NB_ST_FULL state. 

Other possible neighbor states are: 

Neighbor state machine is down. 

In Init state. Waiting for two-way hello from the neighbor. 

In Database Exchange state. Link state record database exchange in 
progress. 

In Database Acknowledge wait state. Waiting for an acknowledgement for 
the link state record database that was sent from the local MP Router. The 
neighbor's database was received already. 

In Database Wait state. Local link state database was acknowledged by the 
neighbor. Waiting for the database from the neighbor. 



NB_ST_DOWN 
NB_ST_INIT 
NB_ST_DB_XCHG 

NB_S T_DB_AC K_WAI T 
NB_ST_DB_WAIT 



Operands 



This command has the following optional operand: 

port 



The port on the local MP Router that connects to the neighbor 
whose FSFP state is to be displayed. 



Examples 



To display the neighbor state of all E Ports: 



switch : adinin> 


nbrstateshow 




Local Domain 


Id: 100 






Local-Port 


Domain 


Remote-Port 


state 


3 


1 


14 


NB_ST_FULL 


4 


1 


13 


NB_ST_FULL 


10 


1 


12 


NB_ST_FULL 


15 


4 


4 


NB_ST_FULL 
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To display the neighbor state of port 3: 



switch: 


; admin> 


nbrstateshow 3 




Local 


Domain 


Id: 100 




Local- 


-Port 


Domain Remote-Port 


state 


3 




1 14 


NB_ST_FULL 



See also 

f abricShow 
interf aceShow 
switchShow 
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nbrStatsClear 



Resets FSPF interface counters. 

Synopsis 

nbrstatsclear [port-num] 

Availability 

admin 

Description 

Use this command to reset the counters of all the different FSPF frames transmitted and received on an 
interface on the MP Router. 

Without parameters, this command resets the counters on all the interfaces. 

Operands 

The following operand is optional: 

port-num The port number of the interface whose counters are to be reset. 

Examples 

To clear the neighbor counter on all E_Ports: 

switch : admin> nbrstatsclear 
NBR Stats Cleared 

To clear the neighbor counter on port 3: 

switch: admin> nbrstatsclear 3 
NBR Stats Cleared 

See also 

interf aceShow 

nbrStateShow 

switchShow 
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nsAllShow 

Displays global Name Server information. 

Synopsis 

nsallshow [-v] 

Availability 

all users 

Description 

Use this command to display the 24-bit Fibre Channel addresses of all devices for all routers or switches in 
the fabric. 

Operands 

The follov/ing operand is optional: 

-V Verbose mode displays additional information, such as class of service, 

device port World Wide Name (WWN), and device node WWN. 

Examples 

To display all the devices in the fabric: 

switch : adinin> nsallshow 

0d02cd Od02ce 0d02dl 0d02d2 0d02d3 Od02d4 0d02d5 0d02dc 
0d02e0 Od02el 0d02e2 0d0600 OdfOOO OdfOOl 0df002 0df003 
Odf004 0df005 0df006 0df007 OdfOOS 0df009 OdfOOa OdfOOb 
OdfOOc OdfOOd OdfOOe OdfOOf 
2 8 Nx_Port devices present in the fabric 
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To display information in verbose mode (-v): 



switch : admin> nsallshow -v 

Type Pid COS Port WWN Node WWN 



NL 


0d02cd 


3 


22 ; 


:00; 


:00; 


:04: 


:cf ; 


:20; 


:54: 


:ad 


20: 


: 00 : 


:00: 


:04: 


:cf : 


:20: 


:54; 


:ad 


NL 


0d02ce 


3 


22 : 


:00: 


;00: 


:04: 


:cf : 


:27 : 


: 12 : 


:29 


20: 


: 00 ; 


: 00 : 


:04: 


:cf : 


:27 : 


: 12 ; 


:29 


NL 


0d02dl 


3 


22 : 


:00: 


;00: 


:04: 


:cf : 


:22 : 


: ea ; 


:ld 


20: 


: 00 ; 


: 00 : 


:04: 


:cf : 


:22 : 


: ea : 


:ld 


NL 


0d02d2 


3 


22 ; 


:00; 


:00: 


:04: 


:cf : 


:22 ; 


: ea : 


:10 


20: 


: 00 : 


:00: 


:04: 


:cf : 


:22 : 


: ea : 


:10 


NL 


0d02d3 


3 


22 ; 


:00; 


:00: 


:04: 


:cf : 


:22 ; 


: ec : 


:Cb 


20: 


: 00 : 


:00: 


:04: 


:cf : 


:22 : 


: ec : 


:cb 


NL 


0d02d4 


3 


22 : 


:00: 


;00: 


:04: 


:cf : 


:22 : 


:ef : 


:b9 


20: 


: 00 ; 


: 00 : 


:04: 


:cf : 


:22 : 


:ef : 


:b9 


NL 


0d02d5 


3 


22 : 


:00: 


;00: 


:04: 


:cf : 


:27 : 


: 10 : 


:dO 


20: 


: 00 ; 


: 00 : 


:04: 


:cf : 


:27 : 


:10: 


:dO 


NL 


0d02dc 


3 


22 ; 


:00; 


:00: 


:04: 


:cf ; 


:1b; 


: ce : 


:C3 


20: 


: 00 : 


:00: 


:04: 


:cf : 


:1b: 


: ce : 


:C3 


NL 


0d02e0 


3 


22 ; 


:00; 


:00; 


:04: 


:cf ; 


:1b: 


:Cl: 


:3e 


20: 


: 00 : 


:00: 


:04: 


:cf : 


:1b: 


:Cl: 


:3e 


NL 


0d02el 


3 


22 : 


:00: 


:00: 


:04: 


:cf : 


:1b: 


:C5: 


:52 


20: 


: 00 ; 


: 00 : 


:04: 


:cf : 


:1b: 


:C5 : 


:52 


NL 


0d02e2 


3 


22 : 


:00: 


;00: 


:04: 


:cf : 


:1b: 


:C5: 


:38 


20: 


: 00 : 


: 00 : 


:04: 


:cf : 


:1b: 


:C5 : 


:38 


N 


odoeoo 


3 


21 ; 


:00; 


:00; 


:eO: 


: 8b; 


:08: 


: f7 : 


:81 


20: 


: 00 : 


:00: 


:eO: 


:8b: 


:08: 


:f7; 


: 81 


N 


Odf 000 


3 


50 ; 


:00; 


:51: 


:el: 


:32 ; 


:60: 


:01: 


:00 


50: 


: 00 : 


:51: 


:el: 


:32 ; 


:60: 


:00: 


:00 


N 


Odf 001 


3 


50 : 


:00: 


:51: 


:el: 


:32 : 


:60: 


:01: 


:01 


50: 


: 00 : 


:51: 


:el: 


:32 : 


:60: 


:00: 


: 00 


N 


Odf 002 


3 


50 : 


:00: 


:51: 


:el: 


:32 : 


:60: 


:01: 


:02 


50: 


: 00 : 


:51: 


:el: 


:32 : 


:60: 


:00: 


: 00 


N 


0df003 


3 


50 ; 


:00; 


:51: 


:el: 


:32 ; 


:60: 


:01: 


:03 


50: 


: 00 : 


:51: 


:el: 


:32 ; 


:60: 


:00: 


:00 


N 


Odf 004 


3 


50 : 


:00; 


:51; 


:el: 


:32 ; 


:60: 


:01: 


:04 


50: 


: 00 : 


:51: 


:el: 


:32 : 


:60: 


:00: 


:00 


N 


OdfOOS 


3 


50 : 


:00: 


:51: 


:el: 


:32 : 


:60: 


:01: 


:05 


50: 


: 00 ; 


:51: 


:el: 


:32 : 


:60: 


:00: 


: 00 


N 


OdfOOe 


3 


50 : 


:00: 


:51: 


:el: 


:32 : 


:60: 


:01: 


:06 


50: 


: 00 ; 


:51: 


:el: 


:32 : 


:60: 


:00: 


: 00 


N 


Odf 007 


3 


50 ; 


:00; 


:51: 


:el: 


:32 : 


:60: 


:01: 


:07 


50: 


: 00 : 


:51: 


:el: 


:32 ; 


:60: 


:00: 


:00 


N 


OdfOOS 


3 


50 ; 


:00; 


:51: 


:el: 


:32 ; 


:60: 


:01: 


:08 


50: 


: 00 : 


:51: 


:el: 


:32 ; 


:60: 


:00: 


:00 


N 


Odf noq 


3 


5 0 : 


: 0 0 : 


: 51 : 


: el : 


: 3 2 : 


: 6 0 : 


: 0 1 : 


: 09 


5 0 : 


: 0 0 : 


: 5 1 : 


: el : 


: 32 : 


: 6 0 : 


: 0 0 : 


: 0 0 


N 


OdfOOa 


3 


50 : 


:00: 


;51: 


:el: 


:32 : 


: 60 : 


:01: 


:0a 


50: 


: 00 ; 


:51: 


:el: 


:32 : 


:60: 


:00: 


: 00 


N 


OdfOOb 


3 


50 ; 


:00; 


:51; 


:el: 


:32 ; 


:60: 


:01: 


:0b 


50: 


: 00 : 


:51: 


:el: 


:32 ; 


:60: 


:00: 


:00 


N 


OdfOOc 


3 


50 ; 


:00; 


:51; 


:el: 


:32 ; 


:60: 


:01: 


:0c 


50: 


: 00 : 


:51: 


:el: 


:32 : 


:60: 


:00: 


:00 


N 


OdfOOd 


3 


50 : 


:00: 


:51: 


:el: 


:32 : 


: 60 : 


:01: 


:0d 


50: 


: 00 ; 


:51: 


:el: 


:32 : 


:60: 


:00: 


: 00 


N 


OdfOOe 


3 


50 : 


:00: 


:51: 


:el: 


:32 : 


: 60 : 


:01: 


:0e 


50: 


: 00 ; 


:51: 


:el: 


:32 : 


:60: 


:00: 


: 00 


N 


Odf OOf 


3 


50 ; 


:00; 


:51; 


:el: 


:32 ; 


:60: 


:01: 


:0f 


50: 


: 00 : 


:51: 


:el: 


:32 : 


:60: 


:00: 


:00 
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See also 

nsShow 
switchShow 
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nsShow 



Displays local Name Server information. 



Synopsis 

nsshow 



Availability 

all users 



Description 

Use this command to display local Name Server information and information about devices connected to 
this MP Router. The nsAllShow command displays information from all MP Routers or sv/itches. 

The message No entries in name server is displayed if there is no information for this MP Router; 
however, there still might be devices connected to other MP Routers or sv/itches in the fabric. Each line of 
output displays the follov/ing information: 

Type U Unknov/n type of device. 

N N Port type of device. 

NL NL_Port type of device. 

Pid The 24-bit Fibre Channel address. 

COS A list of classes of service supported by the device. 

PortName The world wide name of the device port. 

NodeName The world wide name of the device node. There might be 

additional lines if the device has registered any of the following 
information (the MP Router automatically registers SCSI inquiry 
data for Fibre Channel Protocol [FCP] target devices): FC4s 
supported, port and node symbolic names, fabric port name, 
and hard address. 



Operands 

none 

Examples 

To display all the local devices attached to the MP Router: 

switch : admin> nsshow 
{ 

Type Pid COS PortName NodeName 

NL 020d2c; 3 ; 21 : 00 : 00 : 04 : cf : 20 : a4 : 04 ; 20 : 00 : 00 : 04 : of : 20 : a4 : 04 

FC4s: FCP [SEAGATE ST336605FC 0002] 

Fabric Port Name: 2 0 : Od : 00 : 05 : le : 12 : ca : 00 
NL 020d2d; 3 ; 2 1 : 0 0 : 00 : 04 : cf : 2 7 : 2 1 : 3 f ; 2 0 : 00 : 0 0 : 04 : cf : 2 7 : 2 1 : 3 f 

FC4s: FCP [SEAGATE ST336605FC 0002] 

Fabric Port Name: 2 0 : Od : 00 : 05 : le : 12 : ca : 00 



(continued on next page) 
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See also 

nsAllShow 
switchShow 
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passwd 

Changes a user's password. 

Synopsis 

passwd [-U userName] 

Availability 

all users 

Description 

Use this command to change a password. 

When changing a password, you are prompted to enter the old password and the new password, and 
then you are prompted to confirm the new password. 

An admin user can reset other users' passwords to the default password— password— by using the 
-u operand. 

The maximum length of a password is eight characters. 

Operands 

The following operand is optional: 

-u userName Specifies a user name; available only for an admin user. 

Examples 

To change admin 123's password after logging in as admin 123: 

switch : adinin> passwd 
Old password: 
New password: 
Retyped new password: 
The password is changed. 

To reset userl 23's password after logging in as admin: 

switch : adinin> passwd -u userl23 
The password is changed. 

See also 

user Add 
userDel 
userShow 
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pdShow 

Displays data from a panic dump file. 

Synopsis 

pdshow 

Availability 

admin 

Description 

Use tfiis command to display data from a panic dump file. The panic dump file contains information that 
might be useful to determine the cause of a system panic. 

Operands 

none 

Examples 

To display the panic dump file of the MP Router: 

switch : admin> pdshow 

See also 

diagUpload 
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ping 



Sends Internet Control Message Protocol (ICMP) ECHO_REQUEST packets to network hosts. 

Synopsis 

ping [ -adf noqrvDPQRL] [-c count] [-E policy] [-g gateway] [-i interval] 
[-1 ifaddr] [-1 preload] [-p pattern] [-s packetsize] [-t tos] [-T ttl] 
[-w maxwait] host 

Description 

Use this commanci to apply the two IP management ports in the system. For ping functionality on individual 
ports that are configured for IP instead of Fibre Channel, see the rnPing command. 

This command uses the ICMP protocol's mandatory ECHO_REQUEST datagram to elicit an ICMP 
ECHO_RESPONSE from a host or gateway. ECHO_REQUEST datagrams (pings) have an IP and ICMP 
header, followed by a strudtimeval and then an arbitrary number of pad bytes used to fill out the packet. 

Operands 

This command has the following optional operands: 

-a Emits an audible beep (by sending an ASCII BEL character to the 

standard error output) after each unique response is received. This is 
disabled for flood pings, as it might cause temporary delays. 

-c Stops after sending (and waiting the specified delay to receive) count 

ECHO_RESPONSE packets. 

-d Sets the SO_DEBUG option on the socket being used. 

-D Sets the DoNotFragmentbit option in the IP header. This can be used 

to determine the path MTU. 

-E Uses IPsec policy specification string policy ior packets. For the format of 

the specification string, see ipsec_set_policy 3. Note that this 
option is the same as -P in KAME/FreeBSD and KAME/BSDI. -p was 
already occupied in NetBSD. 

-f Floods ping. Outputs packets either as fast as they come back or 1 00 

times per second, whichever is faster. For every ECHO_REQUEST sent, a 
period (.) is printed, while for every ECHO_REPLY received, a backspace 
is printed. This option provides a rapid display of how many packets are 
being dropped. Only the superuser can use this option. 



NOTE: This option can be very hard on a network and should be used 
with caution. 



-g Uses Loose Source Routing to send the ECHO_REQUEST packets through 

gateway. 

-i Waits interval seconds between sending each packet. The default is 

to wait for 1 second between each packet; when the -f operand is used, 
the wait interval is 0.01 second. 

-I Sends multicast datagrams on the network interface specified by the 

interface host name or IP address. 

-h An alternate way of specifying the target host instead of as the last 

argument. 
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-1 If preload is specified, ping sends the packets as fast as possible 

before returning to its normal behavior. Only a superuser can use this 
option. 

-L Disables loopback when sending to multicast destinations so that the 

transmitting host does not see the ICMP requests. 

-n Numeric output only. No attempt is made to look up symbolic names for 

host addresses. 

-o Exits successfully after receiving one reply packet. 

-p The pattern operand allows you to specify up to 16 pad bytes to fill 

out the packet you send. This is useful for diagnosing data-dependent 
problems in a network. For example, -p causes the sent packet to be 
filled with I's. 

-P Use a pseudo-random sequence for the data instead of the default, fixed 

sequence of incrementing 8-bit integers. This is useful to obstruct 
compression on Point-to-Point Protocol (PPP) and other links. 

-q Quiet output. Nothing is displayed except the summary lines displayed at 

startup time and when finished. 

-Q Do not display responses such as Network Unreachable ICMP messages 

concerning the ECHO_REQUESTs sent. 

-r Bypass the normal routing tables and send directly to a host on an 

attached network. If the host is not on a direct-attached network, an error 
is returned. This option can be used to ping a local host through an 
interface that has no route through it. 

-R Record route. Includes the RECORD_ROUTE option in the 

ECHO REQUEST packet and displays the route buffer on returned 
packets. Note that the IP header is large enough for only eight such 
routes (only six when using the -g option). Many hosts ignore or discard 
this option. 

-s The packetsize operand specifies the number of data bytes to be sent. 

The default is 56, which translates into 64 ICMP data bytes when 
combined with the 8 bytes of ICMP header data. The maximum allowed 
value is 65,468 bytes. 

-T The ttl operand allows you to use the specified time-to-live value. 

-t The tos allows you to use the specified hexadecimal type of service. 

-V Verbose output. Received ICMP packets other than ECHO_RESPONSE 

are listed. 

-w The maxwait operand specifies the number of seconds to wait for a 

response to a packet before transmitting the next one. The default is 
10.0. 

When you use ping to isolate faults, run it first on the local host to verify that the local network interface is 
up and running. Subsequently, you can ping hosts and gateways further and further away. 

Round-trip times and packet loss statistics are computed. If duplicate packets are received, they are not 
included in the packet loss calculation, although the round-trip time of these packets is used to calculate 
the minimum/average/maximum round-trip time numbers. 

When the specified number of packets have been sent (and received) or if the program is terminated with 
a SIGINT, a brief summary is displayed. The summary information can be displayed while ping is 
running by sending a SIGINFO signal (see the status argument for stty 1 for more information). 

ping continually sends one datagram per second, printing one line of output for every ECHO_RESPONSE 
returned. On a trusted system with IP security options enabled, if the network idiom is not MONO, ping 
also prints a second line containing the hexadecimal representation of the IP security option in the 
ECHO_RESPONSE. If the -c count option is given, only that number of requests is sent. No output is 
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produced if there is no response. When not using the -f (flood) option, the first interrupt, usually 
generated by Ctrl-C or Delete, causes ping to wait for its outstanding requests to return. It will wait no 
longer than the longest round-trip time encountered by previous, successful pings. The second interrupt 
stops ping immediately. 

This command is intended for use in network testing, measurement, and management. Because of the load 
it can impose on the network, it is unwise to use ping during normal operations or from automated 
scripts. 

ICMP packet details 

An IP header without options is 20 bytes. An ICMP ECHO_REQUEST packet contains an additional 8 
bytes worth of ICMP header, followed by an arbitrary amount of data. When packetsize is specified, 
this indicates the size of this extra piece of data (the default is 56). Thus, the amount of data received 
inside of an IP packet of type ICMP ECHO_REPLY is always 8 bytes more than the requested data space 
(the ICMP header). 

If the data space is at least 8 bytes large, ping uses the first 8 bytes of this space to include a time stamp 
to compute round-trip times. If less than 8 bytes of pad are specified, no round-trip times are given. 

Duplicate and damaged packets 

ping reports duplicate and damaged packets. Duplicate packets should not occur; when they do, they 
are often caused by inappropriate link-level retransmissions. 

Damaged packets are cause for alarm and often indicate broken hardware somewhere in the ping 
packet path (in the network or in the hosts). 

Trying different data patterns 

The (inter)network layer should never treat packets differently based on the data contained in the data 
portion. Unfortunately, data-dependent problems have been known to occur in networks and remain 
undetected for long periods of time. Patterns that have problems often do not have sufficient transitions, 
such as a pattern of all ones or all zeroes, or of nearly all ones or zeroes. It is not necessarily enough to 
specify a data pattern of all zeroes, for example, on the command line, because the pattern that is of 
interest is at the data link level, and the relationship between what you type and what the controllers 
transmit can be complicated. 

This means that if you have a data-dependent problem, you will probably have to do a lot of testing to find 
it. You might find a file that either cannot be sent across your network or that takes much longer to transfer 
than other similar-length files. You can then examine this file for repeated patterns that you can test using 
the -p option of ping. 

See also 

rnPing 
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pkiShow 

Displays existing private key infrastructure (PKI) objects. 

Synopsis 

pkishow -p port 
pkishow -s 
pkishow -a 

Availability 

all users 

Description 

Use this command to display the existence of PKI objects, such as switch private key, private key 
passphrase, CSR, root certificate, and switch certificate. 

Operands 

This command has the following operands: 

-a Displays keys for all the ports. 

-p Specifies the port number to display specific port keys, 

-s Displays keys for the switch entity. 

Examples 

To display the keys on port 0: 

switch : admin> pkishow -p 0 
Keys for port 0 : 



Private Key 
CSR 

Certificate 
Root Certificate 



Exist 
Exist 
Empty 
Exist 



To display the keys for the switch entity: 

switch : admin> pkishow -s 
Keys for Switch 



Private Key 
CSR 

Certificate 
Root Certificate 



Exist 
Exist 
Empty 
Exist 
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To display all the keys installed on the switch: 



switch : adinin> 


pkishow -a 


Keys for port 


0 : 




Private Key 




Exist 


CSR 




Exist 


Certificate 




Empty 


Root Certificate: 


Exist 


Keys for port 


1 : 




Private Key 




Exist 


CSR 




Exist 


Certificate 




Empty 


Root Certificate: 


Exist 


Keys for port 


2 : 




Private Key 




Exist 


CSR 




Exist 


Certificate 




Empty 


Root Certificate: 


Exist 


Keys for port 


3 : 




Private Key 




Exist 


CSR 




Exist 


Certificate 




Empty 


Root Certificate: 


Exist 


Keys for port 


4 : 




Private Key 




Exist 


CSR 




Exist 


Certificate 




Empty 


Root Certificate: 


Exist 


Keys for port 


5 : 




Private Key 




Exist 


CSR 




Exist 


Certificate 




Empty 


Root Certificate: 


Exist 


Keys for port 


6 : 




Private Key 




Exist 


CSR 




Exist 


Certificate 




Empty 


Root Certificate: 


Exist 


(output truncated) 





See also 

none 



XPath OS 7.4.x command reference guide 1 63 



portCfgDefault 

Restore the port configuration to the defaults. 

Synopsis 

portcf gdef ault port 

Availability 

admin 

Description 

Use this command to reset any special configuration values on a port to their factory defaults. The default 
configuration of the port takes effect using the portstart or reboot commands. After running the 
portCfgDefault command, you need to enable the port using the portEnable command, because the 
port is disabled by default. 

Operands 



This command has the following operand: 




port Specifies the port. 




To set port 7 to factory defaults: 




switch : admin> portcf gdef ault 7 
portcf gdef ault is set on port 


To set ports 14 and 1 5 to factory defaults: 


switch : admin> portcf gdef ault 14-15 
portcf gdef ault is set on port 14 
portcf gdef ault is set on port 15 





See also 

portEnable 
portShow 
portstart 
portStop 
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portCfgEPort 

Displays or sets the port to E Port mode. 

Synopsis 

portcfgeport port [1 | 0] 

Availability 

admin 

Description 

Use this command either to set the port to E_Port mode or to prevent setting the port to E Port mode. If no 
parameter is given, the command displays the current mode. If the parameter is given, it enables or 
disables E_Port mode. 

Operands 

This command has the following operands: 

port Identifies the port 

E_Port mode parameters: 

1 Enable 

2 Disable 

Examples 

To display the configured E_Port mode of port 3: 

switch :admin> portcfgeport 3 
port 3 E_Port mode is: ENABLED 

To enable E_Port mode for port 2: 

switch : adinin> portcfgeport 2 1 
port 2 E_Port mode is : ENABLED 



To display the configured E Port mode of ports 3 through 5: 



switch 


admin> 


portcfgeport 3-5 


port 3 


E_Port 


mode is: ENABLED 


port 4 


E_port 


mode is: ENABLED 


port 5 


E_Port 


mode is : ENABLED 



See also 

linkCost 

portCf gSpeed 

portCf gTopology 

portDisable 

portEnable 

portShow 

portType 
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portCfgEXPort 



Sets a port as an EX_Port and sets and displays EX Port configuration parameters. 

Synopsis 

portcf gexport port [-a admin] [-f fabricid] [-r ratov] 
[-e edtov] [-d domainid] [-p pidformat] [-t auto_negotiate_ELP] 

Availability 

admin 

Description 

Use this command to configure an EX Port. 

This command also displays or changes the EX Port configuration. If no optional parameter is given, this 
command displays the currently configured values; otherv/ise, it sets the specified attributes to its new 
value. The port must be stopped (for example, using the portStop command) prior to setting EX_Port 
attributes. The port must be started (for example, using the portStart command) before it can become 
active follov/ing EX Port parameter changes. 

When the port is not active, the preferred domain ID is settable. This is the domain ID that is used by the 
EX_Port's front phantom domain to request a domain ID from the principal sv/itch. The domain ID received 
becomes the subsequent preferred domain ID and is the domain ID that is persisted and displayed. 

When a port changes from an FL_Port to an EX_Port, the topology implicitly changes to point-to-point. 

The output display includes: 

Front domain WWN displays the WWN of the front domain. If the port is enabled and state is "OK", the 
edge fabric principal sv/itch's domain ID and WWN also are displayed. 

Enable or disable Fabric Parameters using the -t operand. Use this attribute to autonegotiate the values of 
R_A_TOV, E_D_TOV, and PID format. If the Fabric Parameters attribute value is autonegotiate, the 
R A TOV and E D TOV values display the negotiated values, indicated by an N next to the value. The 
negotiated values are specified by the edge sv/itch in the ELP request. If the Fabric Parameter attribute 
value is User Configured, the actual configured values are displayed. In such a case, the configured values 
of the EX Port must match that of the edge switch, or else the port is disabled. The default configuration for 
Fabric Parameter is autonegotiate on all EX Ports. 

If the State is Not OK, R_A_TOV and E_D_TOV display N/A (not applicable). 

The security attributes of the EX Port also are displayed. If the EX Port is connected to an edge switch 
without security, the information displays Not Applicable. The Authentication type of None indicates there 
is no authentication on the port. The remaining security attributes, DH Group, Hash Algorithm, and so 
forth, are set to Not Applicable. 

If the edge switch is in secure mode, and assuming the DH-CHAP passwords are configured on both the 
router and edge switch, the security attributes are displayed as follows: 

Authentication Type 

DH Group 

Hash Algorithm 

Edge fabric ' s primary WWN of the primary FCS switch in the secure edge fabric that is 
WWN connected to this EX_Port. Possible values for this field include: 

"WWN of the Primary FCS: The WWN of the primary FCS when 
the edge fabric is secure and the primary FCS is online. 



1 66 XPath OS CLI commands 



Edge fabric's version 
stamp 



"No Primary: Indicates the edge fabric is in secure mode, but there 

is no primary PCS. 

"N/A: The edge fabric is not in secure mode. 

Specifies the version of the security database in the fabric and all 
switches must have the same, or else the port is disabled. Possible 

values include: 

"Version stamp string: The version stamp of the security database 
represented as a string. 

"N/A: The edge fabric is not in secure mode. 



Operands 



This command has the following operands: 



-a 
-f 
-r 

-e 

-d 
-P 



-t 



Specify 1 to enable or 2 to disable the admin. 
Specify 1 to 128 for the fabric ID. 

Specify the R_A_TOV used for port negotiation (E_D_TOV*2 - 
120000). 

Specify the E_D_TOV used for port negotiation 
(1000-R_A_TOV/2). 

Specify 1 to 23 9 for the preferred domain ID. 

Specify 1 for core, 2 for extended edge, and 3 for native port ID 
format. The port ID format is applicable only when -m is set to 0. If 
the operating mode is not Brocade native, the PID format displays 

as Not applicable. 

Specify 1 to enable or 2 to disable autonegotiate fabric 
parameters. 
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Examples 

To display the EX Port configuration of port 0: 



switch: admin> portcf gexport 0 






Admin : 


enabled 






State: 


OK 






Pid format : 


core 






Operate mode : 


Brocade Native 






Edge Fabric ID: 


4 






Front Domain ID: 160 








Principal Switch: 


D 






Principal WWN: 


10:00:00:05:le:34; 


: 11 ; 


:e5 


Front domain WWN: 


50:00:51:el:62:0a: 


: de : 


;00 


Fabric Parameters : 


Auto Negotiate 






R_A_TOV : 


10000 (N) 






E_D_TOV : 


2000 (N) 






Authentication Type: None 






DH Group: N/A 








Hash Algorithm: N/A 








Edge fabric ' s primary 


WWN: N/A 






Edge fabric's version 


Stamp: N/A 







To set tfie fabric ID of port 1 to 5 and the PID format to core: 



switch : admin> portcf gexport 1 -f 5 -p 1 
To configure port 0 to be an EX_Port and set the fabric ID to 4: 

switch : admin> portcf gexport 0 -a 1 -f 4 
To disable auto-ELP on port 0 of an EX_Port: 

switch : admin> portcf gexport 0 -t 2 

See also 

portcf gSpeed 

portDisable 

portEnable 

portShow 

portStart 

portStop 

portType 

secAuthSecret 
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portCfgFcip 

Displays or sets the FCIP port configuration. 

Synopsis 

portcfgfcip slot-port-range [-i ipaddress] [-a admin] [-w wivn] 
[-t tiineout_enforceinent] [-j jumbo_support] [-b bandwidth] 
[-m load_balance_mode {1-, 2-, 3 -none}] 

Availability 

admin 

Description 

Use this command to display or set the FCIP port IP configuration. If no optional parameter is given, this 
command displays the currently configured value; otherv/ise, it sets the specified attributes to the new 
value. 

Operands 

This command has the follov/ing required operand: 

slot-port-range Identifies the slot, port, or range of ports. 

This command has the following optional operands: 

-i ipaddress Sets the remote IP address. 

-a admin Activate or deactivate FCIP as follows: 

1 Activate 

2 Deactivate 

-w wwn Sets the remote WWN. If the remote WWN is configured, the MP 

Router accepts only the incoming FCIP tunnel with the configured 
WWN; it also only initiates a tunnel to the desired MP Router. If 
the remote WWN is not configured, the MP Router accepts FCIP 
connections from any other MP Router. 

-t timeout_enforcement Controls whether or not the FCIP link enforces packet timeouts. If 

configured for timeout enforcement, each outgoing packet is 
stamped with the current time. Each incoming packet uses the 
received timeout to determine if the packet should be dropped. 
The packet's timestamp and the MP Router's configured 
WAN TOV values are compared against the current time. If the 
packet has been in transit for longer than the configured 
WAN TOV time period, the packet is dropped. 

Enable or disable timeout enforcement as follows: 

1 Enable 

2 Disable 

- j jumbo_support If the network supports jumbo frames (2K max FC frame), use the 

- j operand to enable jumbo support on the MP Router. 

Activate or deactivate jumbo support as follows: 

1 Activate 

2 Deactivate 
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-b bandwidth If the available bandwidth for FCIP is low, set the value (Mbit/sec) 

to accomplish better bandwidth utilization. Valid values are 1 to 

1000. 

-m load_balance_mode Sets the load balance mode as follows: 

1 Exchange 

2 SIL_DID 

3 None 

The default is exchange mode. 

Examples 

To display the FCIP configuration of port 3: 

switch : admin> portcfgfcip 3 
admin status : ENABLED 
ipaddress : 1.1.3.1 

wwn : 00:00:00:00:00:00:00:00 

Link Available Bandwidth : 1000 
Jumbo Support is enabled 
WAN_TOV enforcement is disabled 

To set the IP address of port 1 to 1 0. 1 . 1 . 1 : 

switch : admin> portcfgfcip 1 -i 10.1.1.1 
port 1 ipaddress is set to: 10.1.1.1 

See also 

linkCost 
portCfgEPort 
portCf gSpeed 
portCf gTopology 
portDisable 
portEnable 
portShow 
portType 
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portCfgGige 

Displays or sets the IP configuration for a Gigabit Ethernet (GbE) port. 

Synopsis 

portcfggige port [-i ipaddress] [-n netmask] [-g gateway] 
[-p protocol] [-V version] 

Availability 

admin 

Description 

Use this command to allow display of the port's GbE configuration or to change the configuration modes 
of operation. If no optional operand is given, this command displays the currently configured value; 
otherv/ise, it sets the specified attributes to the nev/ value. 

Operands 

This command has the follov/ing required operand: 

port Specifies the port. 

This command has the following optional operands: 

-i ipaddress Sets the IP address, 

-n netmask Sets the netmask. 

-g gateway Sets the default gateway for the GbE port. 

-p protocol Sets the protocol; valid values are FCIP and iSCSl. 

-V version Sets the version number of the protocol. 

Examples 

To display the IP configuration of port 3: 

switch : adinin> portcfggige 3 

To set the IP address of port 2 to 1 0. 1 . 1 . 1 , netmask to 255.255.255.0, and protocol to FCIP 
version 1 : 

switch : admin> portcfggige 2 -i 10.1.1.1 -n 255.255.255.0 -p fcip -v 1 

To set the IP address of port 2 to 1 0. 1 . 1 . 1 , netmask to 255.255.255.0, and protocol to iSCSI 
version 13: 

switch : admin> portcfggige 2 -i 10.1.1.1 -n 255.255.255.0 -p iscsi -v 13 
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See also 

linkCost 
portCfgEPort 
portCf gSpeed 
portCf gTopology 
portDisable 
portEnable 
portShow 
portType 
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portCfg Long Distance 



Configures a port to support long-distance links. 

Synopsis 

portcf glongdistance port [distanceLevel] 

Availability 

admin 

Description 

Use this command to display or set the Fibre Channel port long-distance level. This command allows you 
to allocate enough full-size frames buffers on a particular port to support a long-distance link up to 
300 km. 

Operands 

This command has the following required operand: 

port Specifies the port. 

This command has the following optional operand: 

distanceLevel Specifies the distance level. The value of distanceLevel can be one 

of the following: 

LO Specifies that the port be a regular switch port. The switch-wide 

BB_Credit setting is used at these ports. 

LE Supports distances up to 10 km at both 1-Gb/s and 2-Gb/s 
speeds. 

LO . 5 Supports distances up to 25 km at both 1-Gb/s and 2-Gb/s 
speeds. 

LS Supports distances up to 300 km at both 1-Gb/s and 2-Gb/s 

speeds. 

^ ^^To display the distance level for the configured port 7: 

switch : adinin> portcf glongdistance 7 
port 7 distance level is LO . 5 

To set the distance level to LO for port 7: 

switch : adinin> portcf glongdistance 7 LO 
Distance level is set to LO on port 7 
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conf igShow 

configure 

portDisable 

portEnable 

portShow 

portType 
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portCfgSpeed 

Displays or sets the configured port speed. 

Synopsis 

portcf gspeed port [speed] 

Availability 

admin 

Description 

Use this command to display or set the configured Fibre Channel port speed. If the speed operand is 
given, the command sets the port to the specified new speed. If no speed operand is given, the command 
displays the currently configured port speed. 

The port must be disabled before the speed can be changed. 

If you use this command to configure the Gigabit Ethernet (GbE) port speed, the following message is 
displayed: 

Port speed is not configurable for GIGE ports. 

Operands 

This command has the following required operand: 

port Specifies the port. 

This command has the following optional operand: 

speed Specifies the speed. The value of speed can be one of the following: 

0 AN (autonegotiate) 

1 1 Gb/s 

2 2 Gb/s 

Examples 

To display the configured speed of port 7: 

switch :ad[nin> portcfgspeed 7 
port 7 speed is set to: AN 



To set the speed of port 1 to 2 Gb/ s: 



switch :adinin> portcfgspeed 1 2 
port 1 speed is set to: 2G 



To set the speed of ports 2, 3, 1 0, and 1 2 to autonegotiate: 



switch :admin> portcfgspeed 2,3,10,12 0 
port 2 speed is set to: AN 
port 3 speed is set to: AN 
port 10 speed is set to: AN 
port 12 speed is set to: AN 
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See also 

linkCost 

portCfgEPort 

portCf gTopology 

portDisable 

portEnable 

portShow 
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portCfgTopology 



Displays or sets the configured port topology. 

Synopsis 

portcf gtopology port [topology] 

Availability 

admin 

Description 

Use this command to display or set the configured Fibre Channel port topology. If the topology 
parameter is specified, the command sets the port to the specified new topology. If no parameter is 
specified, the command displays the currently configured port topology. 

If the port is configured as an E Port or EX Port, the topology is implicitly changed to point-to-point. 

Operands 

This command has the following required operand: 

port Specifies the port. 

This command has the following optional operand: 

topology Specifies the topology. The value of topology car\ be: 

p Point-to-point 

Examples 

To set the topology of port 1 to point-to-point: 

switch :adinin> portcf gtopology 1 p 
port 1 topology set to: P-P 
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See also 

portCfgEPort 

portCf gSpeed 

portDisable 

portEnable 

portShow 

portType 
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portDiagClear 

Clears the port diagnostic error. 

Synopsis 

portdiagclear port_list 

Availability 

admin 

Description 

If a port is marked as faulty after running a diagnostic command, another diagnostic cannot be run on the 
same port (because it is already faulty). Use this command to clear that faulty condition and allow the 
same or another diagnostic command to run on that port. 

If you fix the fault in the port and intend to bring the port online, first run portDiagClear, followed by 
portStop and then portStart, on the port. 

Operands 

This command has the following required operand: 
port_list Specifies a list of ports. 

Examples 

To clear diagnostic errors on ports 0, 3, and 8 through 10: 



switch : adinin> portdiagclear 0,3,8-10 


Diag result of port 


0 is cleared 


Diag result of port 


3 is cleared 


Diag result of port 


8 is cleared 


Diag result of port 


9 is cleared 


Diag result of port 


10 is cleared 



See also 

portStart 
portStop 
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portDiagDisable 



Disables the port for diagnostics. 

Synopsis 

portdiagdisable port_list 

Availability 

admin 

Description 

Use this command to set the port to normal mode if the port was in diagnostic mode. The port must be 
returned to normal mode after running a diagnostic command in order to resume normal operation of that 
port. After running all the selected diagnostic commands on a set of ports, all those ports should be 
returned to normal mode using the portDiagDisable command. 

Use the portShow command to view the current port state. 

All port LEDs are off after a port is placed in diagnostic mode. If a port fails the diagnostic test, all port 
LEDs are solid yellow. 

Operands 

This command has the following required operand: 
port_list Specifies a list of ports. 

Examples 

To set ports 0, 3, and 8 through 1 0 to normal mode after running diagnostics: 

switch : admin> portdiagdisable 0,3,8-10 

Port 0 is now in normal mode 
Port 3 is now in normal mode 
Port 8 is now in normal mode 
Port 9 is now in normal mode 
Port 10 is now in normal mode 

See also 

portDiagEnable 
portShow 



1 80 XPath OS CLI commands 



portDiagEnable 



Enables the port for diagnostics. 

Synopsis 

portdiagenable port_list 

Availability 

admin 

Description 

Use this command to place one or more ports in diagnostic mode, so that a diagnostic command can be 
run. If a diagnostic command involves multiple ports, all the ports must be enabled for diagnostics first. 

After a port is enabled for diagnostics, any number of MP Router diagnostic commands can be run on that 
port; hov/ever, the normal operation of the port ceases. 

Diagnostic mode is nonpersistent; it is not retained if the MP Router is rebooted. 
Use portShow to obtain the current port state. 

Operands 

This command has the following operand: 

port_list Specifies a list of ports. 

Examples 

To enable ports 0, 3, and 8 through 1 0 for diagnostics: 

switch : adinin> portdiagenable 0,3,8-10 

See also 

portDiagDi sable 
portShow 
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portDisable 

Disables a port. 

Synopsis 

portdisable port 

Availability 

admin 

Description 

Use this command to disable a port. You can use this command to quickly disable or stop the laser on the 
port when troubleshooting a connected device. However, use the portstop command to stop the code to 
a port for more involved troubleshooting or for reconfiguring the port to Fibre Channel or IP. 

Operands 

This command has the following required operand: 
port Specifies the port. 

Examples 

To disable port 3: 

switch: admin> portdisable 3 
port 3 disabled 

To disable ports 3 through 6: 

switch: admin> portdisable 3-6 
port 3 disabled 
port 4 disabled 
port 5 disabled 
port 6 disabled 



See also 



portEnable 

portShow 

portStart 

portstop 

portType 

switchShow 
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portEnable 

Enables a port. 

Synopsis 

portenable port 

Availability 

admin 

Description 

Use this command to enable a port. This command starts the port laser, unlike the portStart command, 
which loads the port code. 

Operands 

This command has the following required operand: 
port Specifies the port. 

Examples 

To enable port 3: 

switch : adinin> portenable 3 
port 3 enabled 

To enable ports 3 through 6: 

switch : adinin> portenable 3-5 
port 3 enabled 
port 4 enabled 
port 5 enabled 
port 6 enabled 

See also 

portDisable 

portShow 

portStart 

portStop 

portType 

switchShow 
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portErrShow 

Displays a port error summary. 

Synopsis 

porterrshow 

Availability 

all users 



Description 

Use this command to display an error summary for all ports. One output line is displayed per port; error 
counters are displayed in ones, thousands (the number is followed by k), millions (the number is followed 

by m), or billions (the number is followed by g.) For Ethernet ports, some counters display NA, if the 
counters are not applicable. 

The display includes: 

port type FC for Fibre Channel; GE for Gigabit Ethernet 

frames tx Frames transmitted 

frames rx Frames received 

enc in Encoding errors inside of frames 

crc err Frames with CRC errors 

too shrt Frames that are too short 

too long Frames that are too long 

bad eof Frames with bad end-of-frame delimiters 

enc out Encoding error outside of frames 

disc c3 Class 3 frames discarded 

link fail Link failures (LFl or LF2 states) 

loss sync Loss of synchronization 

loss sig Loss of signal 

frjt Frames rejected with F_RJT 

fbsy Frames busied with F_BSY 
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Examples 

To display the port error summary: 



FabricAP 


:admin> porter rshow 
























port 


frames 


enc 


crc 


too 


too 


bad 


enc 


disc 


link 


loss 


loss 


f rjt 


fbsy 




type 


tx 


rx 


in 


err 


shrt 


long 


eof 


out 


c3 


fail 


sync 


sig 






0 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


1 


FC 


10.9k 


10.9k 


0 


0 


0 


0 


0 


0 


0 


35 


4 


0 


0 


12 


2 


FC 


9 . 5k 


9 . 5k 


0 


0 


0 


0 


0 


0 


0 


2 


45 


0 


6 


0 


3 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


4 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


5 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


6 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


7 


GE 


278 


280 


NA 


0 


0 


0 


NA 


NA 


0 


NA 


NA 


NA 


NA 


NA 


8 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


9 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


10 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


11 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


12 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


13 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


14 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


15 


FC 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 



See also 

portShow 
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portLogClear 

Clears port logs. 

Synopsis 

portlogclear [port_nuni] 

Availability 

admin 

Description 

Use this command to clear port logs. If no parameter is specified, all port logs are cleared. 

Clear the port log before triggering an activity you want to observe. For example, if the port log is cleared 
immediately before connecting an F_Port to the MP Router, portLogShow displays activity related to the 
F_Port coming online. 

See portLogShow for a description of port logs. 

Operands 

This command has following optional operand: 

port_nuin Specifies the port number. Only the specified port logs are 

cleared. Valid port numbers are: 

0-15 External ports 

16 Bridge port (an internal port) 

17 Central processor (CP) 

Examples 

To clear the port log for port 9: 

switch : admin> portlogclear 9 
portlog of port 9 cleared 

To clear all port logs: 

switch : admin> portlogclear 
All portlogs cleared 

See also 

portLogDi sable 

portLogDump 

portLogEnable 

portLogShow 

upTime 
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portLog Disable 

Disables port logs. 

Synopsis 

portlogdisable [port_nuin] 

Availability 

admin 

Description 

Use this command to disable port logs. If no parameter for port_num is specified, all port logs are 
disabled. If port_num is specified, only the port log for that port is disabled. 

See portLogShow for a description of port logs. 
NOTE: By default, the port logs are enabled. 

Operands 

The following operand is optional: 

port_num Specifies which ports should be disabled. Valid port numbers 

are: 

0-15 External ports 

16 Bridge port (an internal port) 

17 Central processor (CP) 

Examples 

To disable the port log for port 9: 

switch : adinin> portlogdisable 9 
portlog of port 9 disabled 

To disable all port logs: 

switch : adinin> portlogdisable 
All portlogs disabled 

See also 

portLogClear 

portLogDump 

portLogEnable 

portLogShow 

upTime 
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portLogDump 



Displays port logs, without page breaks. 



Synopsis 



portlogdump [-c count] [port_nuin] 



Availability 

admin 

Description 

Use this command to display all entries in the port log, without page breaks. The portLogDump 
command is similar to the portLogShow command, which paginates the output. If the port log is 
disabled, an error message is displayed. The actual message varies, depending on the way in which the 
command is entered, as follows: 

• If the command is entered with port_num specified, the message is: 

WARNING: Port log is disabled for this port 

• If the command is entered using a range for port_num, the message is: 
WARNING: Port log is disabled for port{s) 

• If the command is entered without operands, the message is: 
WARNING: Port log is disabled for all ports 

See portLogShow for a description of port logs. 

The following fields are displayed: 

Time Date and time of the event. 

Module Name of the module that logged the event. 

Event Possible events include: 

PrtDis Port disabled. 

PrtEnab Port enabled. 

PrtStart Port start. 

PrtStop Port stop. 

PrtSCN Port state change. 

lOCTL lOCTL execution context. 

Tx Frame transmitted. 

Tx_Ackl ACK l transmitted. 

Rx Frame received. 

Rx_LC Received a link control frame. 

Rx_Ackl Received ACK_1 . 

Ct_in Received a CT-based request. 

Ct_out Transmitted a CT-based response. 

nbr_sm FSPF's neighbor state machine state 

transition. 

RSCN RSCN transmitted. 

SWRSCN Switch RSCN transmitted. 
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Debug Debug information. 

Port Port number of the affected port. 

Len Frame length; 0 for non-frame-related log entries. 

Log Info Log record information. The log record might be in string format 

(for example, in PrtSCN event) or a list of integers (for example, 
Tx/Rx events). 

Refer to the HP StorageWorks XPath OS 7.4.x system error messages reference guide. 

Operands 

The follov/ing operands are optional: 

-c count Maximum number of lines to display. Only the most recent count entries 

are displayed. 

port_nuitt Only the specified port logs are displayed. Valid port numbers are: 

0-15 External ports 

16 Bridge port (an internal port) 

17 Central processor (CP) 

Examples 

To display the port log for port 1 2: 

switch : adinin> portlogdump 12 

Total records present = 81 

Number of records displayed = 81 



Time 






Module 


Event 


Port 


Len 


Log info 


16; 


:24; 


:35, 


.765 


fabctl 


PrtSCN 


12 


0 


st=l, Topo=2, Spd=0 


16; 


:24; 


:36, 


.076 


fabctl 


PrtSCN 


12 


0 


st=2, Topo=2, Spd=2 


16 ; 


:24; 


:37, 


.167 


fabctl 


Tx 


12 


128 


02fffffd,00fffffd,01c6ffff, 10000000 


16 ; 


:24; 


:37 


.167 


WKA 


Rx_Ackl 


12 


24 


cOf f f f fd, OOf f f f fd, 01c60001 


16; 


:24; 


:37, 


.169 


WKA 


Tx_Ackl 


12 


24 


c0fffffd,00fffffd,01c60001 


16; 


:24; 


:37, 


.169 


WKA 


Rx 


12 


128 


03fffffd,00fffffd, 01c 60001, 02 000000 


16; 


:24; 


:37, 


. 170 


fabctl 


PrtSCN 


12 


0 


st=2, Topo=2, Spd=2 


16; 


:24; 


:37, 


. 171 


fabctl 


Tx 


12 


48 


02fffffd,00fffffd, 01c7ffff, 30000018 


16; 


:24; 


:37, 


. 171 


WKA 


Rx_Ackl 


12 


24 


cOfffffd,OOfffffd, 01c70001 


16; 


;24; 


:37, 


. 171 


WKA 


Tx_Ackl 


12 


24 


cOf f f f fd, OOf f f f fd, 01c70001 
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16 


: 24 : 


: 37 , 


. 171 


WKA 


Rx 




12 


48 


03fffffd,00fffffd,01c70001, 02000000 


16 


: 24 : 


: 37 , 


. 172 


WKA 


Tx_ 


_Ackl 


12 


24 


cOf f f f fd, OOf f f f fd, lba70001 


16 


: 24 : 


; 37 . 


. 172 


WKA 


Rx 




12 


64 


02ff ff fd, OOf ff ffd, lba7f ff f , 14000000 


16 


: 24 : 


; 37 . 


. 172 


f abctl 


nbr_sin 


12 


0 


Down to Down 


16 


: 24 : 


: 37 , 


. 172 


f abctl 


nbr_sm 


12 


0 


Down to Init 


16 


: 24 : 


: 37 , 


. 172 


WKA 


Tx_ 


_ACK1 


12 


24 


cOfffffd,OOfffffd, 08860001 


16 


: 24 : 


; 37 . 


. 172 


WKA 


Rx 




12 


92 


02fffffd,00fffffd,0886ffff, 70840900 


16 


: 24 : 


; 37 . 


. 172 


f abctl 


Tx 




12 


64 


02fffffd,00fffffd, lab7f f f f , 14000000 


16 


: 24 : 


: 37 , 


. 173 


WKA 


Rx_ 


_Ackl 


12 


24 


cOf f f f fd, OOf ff ffd, lab70001 


16 


: 24 : 


: 37 , 


. 173 


WKA 


Tx_ 


_ACK1 


12 


24 


cOfffffd,OOfffffd, 08870001 


16 


: 24 : 


; 37 . 


. 173 


WKA 


Rx 




12 


248 


02fffffd,00fffffd,0887ffff,111000e0 


16 


: 24 : 


; 37 . 


. 173 


f abctl 


Tx 




12 


92 


02fffffd,00fffffd,01c8ffff, 70840900 


16 


: 24 : 


: 37 , 


. 173 


WKA 


Rx_ 


_Ackl 


12 


24 


cOf f f f fd, OOf ff ffd, 01c80001 


16 


: 24 : 


: 37 , 


. 173 


WKA 


Tx_ 


A ^ VI 


12 


24 


cOfffffd,OOfffffd, 08880001 


16 


: 24 : 


; 37 . 


. 173 


WKA 


Rx 




12 


40 


02fffffd,00fffffd,0888ffff, 12000000 


16 


: 24 : 


; 37 . 


. 174 


f abctl 


Tx 




12 


248 


02fffffd,00fffffd,01c9ffff,111000e0 


16 


: 24 : 


: 37 , 


. 174 


WKA 


Rx_ 


_Ackl 


12 


24 


cOf f f f fd, OOf ff ffd, 01c90001 


16 


: 24 : 


: 37 , 


. 174 


WKA 


Tx_ 


A ^ VI 


12 


24 


cOf f f f fd, OOf ff ffd, lba80001 


16 


: 24 : 


; 37 . 


. 174 


WKA 


Rx 




12 


64 


02fffffd,00fffffd, lba8f f f f , 14000000 


16 


: 24 : 


; 37 . 


. 175 


f abctl 


Tx 




12 


40 


02fffffd,00fffffd, Olcaf f f f , 12000000 


16 


: 24 : 


: 37 , 


. 175 


WKA 


Rx_ 


_Ackl 


12 


24 


cOf f f f fd, OOf ff ffd, OlcaOOOl 


16 


: 24 : 


: 37 , 


. 175 


WKA 


Tx_ 


_Ackl 


12 


24 


cOf f f f fd, OOf ff ffd, lba90001 


16 


: 24 : 


; 37 . 


. 175 


WKA 


Rx 




12 


224 


02fffffd,00fffffd, lba9f f f f , 15000000 


16 


: 24 : 


; 37 . 


. 175 


f abctl 


Tx 




12 


64 


02fffffd,00fffffd, lab8f f f f , 14000000 


16 


: 24 : 


: 37 , 


. 176 


WKA 


Rx_ 


_Ackl 


12 


24 


cOf f f f fd, OOf ff ffd, lab80001 


16 


:24: 


:37 , 


. 176 


fabctl 


nbr_sin 


12 


0 


Init to DBExch 


16 


:24: 


;37 . 


. 176 


WKA 


Tx_ 


_Ackl 


12 


24 


cOf f f f fd, OOf ff ffd, 01c80001 


16 


:24: 


;37 . 


. 176 


WKA 


Rx 




12 


32 


03fffffd,00fffffd,01c80001, 01000000 



See also 

portLogClear 
portLogDi sable 
portLogEnable 
portLogShow 
upTime 
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portLogEnable 



Enables port logs. 



Synopsis 

portlogenable [port_nuni] 

Availability 

admin 

Description 

Use this command to enable port logs. If no parameter is specified, all port logs are enabled. If 
port_num is specified, only the port log for the specified ports are enabled. 



["2^ NOTE: By default, the port logs are enabled. 



Examples 

To enable the port log for port 9: 

switch : adinin> portlogenable 9 
portlog of port 9 enabled 

To enable all port logs: 

switch : adinin> portlogenable 
All portlogs enabled 

See also 

portLogClear 
portLogDi sable 




Operands 



The following operand is optional: 



port_num 



Only the specified port log is enabled. Valid port numbers are: 
0-15 External ports 

16 Bridge port (an internal port) 

17 Central processor (CP) 



portLogDump 



portLogShow 



upTime 
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portLogShow 



Displays port activity logs. 



Synopsis 



portlogshow [-c count] [port_nuitt] 



Availability 

admin 



Description 

Use this command to display port logs, paginated. The portLogShow command is similar to 
portLogDump, which does not paginate the output. 

A port log internally stores entries for each port as a circular buffer. Each port has space to store 2048 log 
entries. If a port log is disabled, an error message is displayed. The actual message varies, depending on 
the way in which the command is entered, as follows: 

• If the command is entered using a range for port_num: 

WARNING: Port log is disabled for port{s) 

• If the command is entered without operands: 

WARNING: Port log is disabled for all ports 

• If the command is entered with port_num specified: 

WARNING: Port log is disabled for this port 
The following fields are displayed: 



Time 

Module 

Event 



Date and time of the event. 

Name of the module that logged the event. 

Possible events include: 

PrtDis Port disabled. 

PrtEnab Port enabled. 

PrtStart Port start. 

PrtStop Port stop. 

PrtSCN Port state change. 

lOCTL lOCTL execution context. 

Tx Frame transmitted. 

Tx_Ackl ACK l transmitted. 

Rx Frame received. 

Rx_LC Received a link control frame. 

Rx_Ackl Received ACK_1 . 

Ct_in Received a CT-based request. 

Ct_out Transmitted a CT-based response. 

nbr_sm FSPF's neighbor state machine state 

transition. 

RSCN RSCN transmitted. 

SWRSCN Switch RSCN transmitted. 

Debug Debug information. 
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Port Port number of the affected port. 

Len Frame length; 0 for non-frame-related log entries. 

Log Info Log record information. The log record might be in string format 

(for example, in PrtSCN event) or a list of integers (for example, 
Tx/Rx events). 

Refer to the HP StorageWorks XPath OS 7.4.x system error messages reference guide. 

Operands 

The following operands are optional: 

-c count Maximum number of lines to display. Only the most recent 

count entries are displayed. 

port_num Only the specified port logs are displayed. Valid port numbers 

are: 

0-1 5 External ports 

16 Bridge port (an internal port) 

17 Central processor (CP) 
Leave this value empty to display all port logs. 

Examples 

To display the port log for port 8: 

switch ; adinin> portlogshow 8 
Total records present = 25 

Number of records displayed = 25 



Time 






Module 


Event 


Port 


Len 


Log info 




18: 


:36 ; 


:52, 


.036 


fabctl 


PrtSCN 


08 


0 


st=l, Topo=2, Spd=0 




18; 


:36 ; 


:52, 


.361 


WKA 


Rx 


08 


140 


22fffffe, 00000000, 01a6f fff , 


04000000 


18; 


:36 ; 


:52, 


.362 


fabctl 


PrtSCN 


08 


0 


st=2, Topo=2, Spd=2 




18; 


:36 ; 


:52 


.365 


fabctl 


Debug 


08 


0 


Loading routes 




18; 


:36 ; 


:52 


.379 


fabctl 


Tx 


08 


140 


23640800, OOfffffe, 01a60001, 


02000000 


18; 


:36 ; 


:52, 


.379 


WKA 


Rx 


08 


140 


22fffffc, 00640800, 02cef fff , 


03000000 


18; 


:36 ; 


:52, 


.382 


nsd 


Tx 


08 


140 


23640800, OOfffffe, 02cef f f f , 


02000000 


18; 


:36 ; 


:52, 


.382 


WKA 


Rx 


08 


32 


22fffffd, 00640800, 02cdf f f f , 


62000000 


18; 


:36 ; 


:52 


.383 


fabctl 


Tx 


08 


28 


23640800, OOfffffd, 02cd0001, 


02000000 


18; 


:36 ; 


:52, 


.383 


WKA 


Ct_in 


08 


52 


02fffffc, 00640800, 02dlffff, 


01000000 


18; 


:36 ; 


:52, 


.384 


nsd 


Tx 


08 


40 


03640800, OOfffffe, 02dlffff, 


01000000 


18; 


:36 ; 


:52, 


.384 


WKA 


Ct_in 


08 


84 


02fffffe, 00640800, 02d0ffff, 


01000000 


18; 


:36 ; 


:52, 


.384 


nsd 


Tx 


08 


40 


03640800, OOfffffe, 02d0ffff, 


01000000 


18; 


:36 ; 


:52, 


.385 


WKA 


Ct_in 


08 


76 


02fffffe, 00640800, 02d7ffff, 


01000000 


18; 


:36 ; 


:52, 


.389 


nsd 


Tx 


08 


40 


03640800, OOfffffe, 02d7ffff, 


01000000 


18; 


;36 ; 


:52, 


.389 


WKA 


Rx 


08 


40 


22fffffe, 00640800, 02 88ffff, 


05000000 



(continued on next page) 
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18 : 


: 36 ; 


: 52 , 


.390 


nsd 


Tx 


08 


28 


23640800, 00fffffc,0288ffff, 02000000 


18 : 


: 36 : 


: 52 


.391 


WKA 


Rx 


08 


140 


22fffffc, 00640800, 02 d6ffff, 03000000 


18 : 


: 36 : 


; 52 


.394 


nsd. 


Tx 


08 


140 


23640800, OOfffffc, 02 d6ffff, 02000000 


18 : 


: 36 ; 


; 52 


.394 


WKA 


Ct_in 


08 


44 


02fffffc, 00640800, 02 d9ffff, 01000000 


18 : 


: 36 : 


: 52 


.404 


msd 


Tx 


08 


140 


22640800, 0064fla8, 5005ffff, 03000000 


18 : 


: 36 : 


: 52 


.404 


msd 


Tx 


08 


32 


22640800, 0064fla8, 5006ffff, 78000000 


18 : 


:36; 


;52 


.404 


msd 


Tx 


08 


40 


22640800, 0 0 64fla8, 5005ffff, 05000000 


18 : 


:36; 


;55 


.326 


nsd 


Ct_out 


08 


0 


ns query acc 171 5 


18 ; 


:36: 


:55 


.327 


nsd 


Tx 


08 


60 


03 640800, OOfffffc, 02d90001, 01000000 



See also 

portLogClear 
portLogDi sable 
portLogDump 
portLogEnable 
upTime 
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portLoopbackTest 



Tests the wire-side transmitting and receiving paths of one or more ports. 



Synopsis 



portloopbacktest [-p port_list] [-n franie_count] [-1 length] [-s speed] 
[-m mac] [-h loopback] 



Availability 

admin 



Description 

Use this command to test the wire-side operation of one or more ports. This test generates frames from a 
port and loops them back to itself. The loopback path can be either internal or external. 

Each participating port is both a frame producer and a frame consumer. The transmitting and receiving 
operations happen in parallel. The transmitter attempts to send out frames, independent of the status of the 
receiver. 

All ports involved in the test must be diagnostics-enabled prior to running this test. 



Operands 



This command has the following operands: 



-p port_list 
-n frame_count 

-1 length 

-s speed 



-m mac 



-b loopback 



Specifies a list of source ports. The default value is all ports. 

Specifies the number of frames to send to each destination. The 
default value is 2 5 6. 

Specifies the payload length of the test frames. The default value 

is 1024. 

Specifies Fibre Channel speed mode. The default value is 2 Gb. 

0 Autonegotiate 

1 1 Gb 

2 2 Gb 

Specifies the MAC layer to activate. The default is Fibre Channel. 

0 Fibre Channel 

1 Gigabit Ethernet 

Specifies the loopback mode. The default is internal loopback. 

0 Internal loopback through the 
serializer/deserializer (SERDES) 

1 External loopback through loopback plug or 
fiber 
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Examples 

To send out 1024 frames from ports 0 and 1 in Fibre Channel mode: 



switch : admin> 


portloopbacktest -p 0-1 -n 256 -1 1024 -b 0 - 


-s 2 - 


-m 0 




portloopbacktest -p 0-1 -n 256 -1 1024 -b 0 -s 2 -m 0 








Port Tx fr 


Tx bytes Rx fr Rx bytes Deli Size 


In 


Out 


RSLT 


0000 00000100 


000000041C00 00000100 000000041COO 0000 0000 


0000 


0000 


PASS 


0001 00000100 


00000Q041C00 00000100 000000041C00 0000 0000 


0000 


0000 


PASS 


To send out 1024 frames from ports 1 2 and 1 3 in Gigabit Ethernet mode: 


switch : admin> 


portloopbacktest -p 12-13 -n 1024 -1 1024 -m 


1 






portloopback - 


-p 12-13 -n 1024 -1 1024 -b 0 -s 2 -m 1 








Port Tx fr 


Tx bytes Rx fr Rx bytes CrcT CrcR 


BadT 


BadR 


RSLT 


OOOC 00000400 


000000104800 00000400 000000104800 0000 0000 


0000 


0000 


PASS 


OOOD 00000400 


000000104800 00000400 000000104800 0000 0000 


0000 


0000 


PASS 



See also 

crossPortTest 
portDiagDi sable 
portDiagEnable 
spinSilk 
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portName 

Displays or sets the configured port name. 

Synopsis 

portname port [portname] 

Availability 

admin 

Description 

Use this command to display or set the configured port name. If a parameter is specified for portname, 
the command sets the port to the specified new port name. If no parameter is specified for portname, the 
command displays the currently configured port name. 

Operands 

This command has the following optional operand: 

portname Specifies the port name. The maximum name length is 32 characters. 

The name must be either letters, digits, underscores, or spaces only. The 
first character of the name must be either a letter or a digit. 

Examples 

To display the configured name of port 8: 

switch : adinin> portname 8 
Port 8 name : port_8 

To set the name of port 8 to "port 3_8": 

switch : admin> portname 8 port3_8 
port 8 set to name port3_8 

See also 

portShow 
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portPerfShow 



Displays port throughput numbers. 

Synopsis 

portperfshow [interval] 

Availability 

all users 

Description 

Use this command to display port throughput numbers for all ports on the MP Router. One output line is 
displayed every five seconds (or longer if interval is specified) until you press Ctrl-C. The command 
and port number heading is repeated every 16 lines. 

The Total column displays the sum of all throughput values of all ports. 

The numbers displayed represent the number of bytes received and the number of bytes transmitted per 
second. Throughput numbers are displayed as either bytes/second, kilobytes/second (the number is 
follov/ed by k), megabytes/second (the number is followed by m), or (for Total column alone) 
gigabytes/second (the number is followed by g). 

This information is used to monitor port performance. 
Operands 

This command has the following optional operand: 

interval The interval, in seconds, between each sample. The minimum 

interval allowed is 5 seconds. If an interval is not specified, a 
default interval of 5 seconds is used. 



Examples 

To display port throughput numbers for all ports on the MP Router at the default display interval of 
5 seconds: 



switch : adinin> 


portperfshow 


























Data 


Sampled every 


5 seconds . 
























portperfshow 5 
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FC 


FC 


FC 


FC 


FC 


FC 


FC 


FC 


FC 
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(continued 


on 


next 


page) 



























1 98 XPath OS CLI commands 



0 


0 


0 


0 


0 


0 


0 


0 


186m 


0 


0 


186m 


0 


0 


0 


0 


373m 


0 


0 


0 


0 


0 


0 


0 


0 


187m 


0 


0 


187m 


0 


0 


0 


0 


37 5m 


0 


0 


0 


0 


0 


0 


0 


0 


189m 


0 


0 


189m 


0 


0 


0 


0 


37 9m 


0 


0 


0 


0 


0 


0 


0 


0 


186m 


0 


0 


186m 


0 


0 


0 


0 


373m 


0 


0 


0 


0 


0 


0 


0 


0 


186m 


0 


0 


186m 


0 


0 


0 


0 


373m 


0 


0 


0 


0 


0 


0 


0 


0 


189m 


0 


0 


189m 


0 


0 


0 


0 


37 9m 


0 


0 


0 


0 


0 


0 


0 


0 


186m 


0 


0 


186m 


0 


0 


0 


0 


373m 


0 


0 


0 


0 


0 


0 


0 


0 


186m 


0 


0 


186m 


0 


0 


0 


0 


373m 


0 


0 


0 


0 


0 


0 


0 


0 


187m 


0 


0 


186m 


0 


0 


0 


0 


37 4m 


portperfshow 5 






























0 


1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


13 


14 


15 


Total 


FC 


FC 


FC 


FC 


FC 


FC 


FC 


FC 


FC 


FC 


FC 


FC 


FC 


FC 


FC 
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0 


0 


0 


0 


0 


0 


0 


0 


185m 


0 


0 


185m 


0 


0 


0 


0 


371m 



See also 

portShow 
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portRoutelnfo 



Displays port routing tables for a specific port. 

Synopsis 

portrouteinf o port_number 

Availability 

all users 

Description 

Use this command to display a given port's routing information. 

Operands 

This command has the following required operand: 
port_number Specifies the port number. 

Examples 

To display port routing tables for port 1 : 



switch 


admin> portrouteinf o 1 


Domain 


Id 




58 Exit Port = 13 


Domain 


Id 




70 Exit Port = 4 


Domain 


Id 




71 Exit Port = 11 


Domain 


Id 




73 Exit Port = 1 


Domain 


Id 




76 Exit Port = 1 


Domain 


Id 




78 Exit Port = 5 


Domain 


Id 




79 Exit Port = 6 


Domain 


Id 




80 Exit Port = 4 


Domain 


Id 




81 Exit Port = 5 


Domain 


Id 




100 Exit Port = 6 


Domain 


Id 




116 Exit Port = 1 



See also 

f abricShow 
switchShow 
topologyShow 
urouteShow 
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portShow 



Displays port configuration, status, and traffic statistics. 



Synopsis 



portshow port 



Availability 

all users 

Description 

Use tfiis command to display all 
statistics. 

Tfie command output includes: 

Name 

State 

STARTED 
STOPPED 
UP 

DOWN 

DIAGNOSTIC 
DOWNLOADING_CODE 
Type 
FC 

GIGE 
Link Status 
ENABLED 
DISABLED 
UP 

DOWN 
Topology 

P-P 
Speed 

IG 

2G 

AN 

Link Cost 

0 (Auto) 

1 Gb/s 

2 Gb/s 
1-65535 

WWN 



port configuration information, including the operational status and traffic 



Port configuration state is started. 

Port configuration state is stopped. 

Port operational state is up. 

Port operational state is down. 

Port operational state is in diagnostic mode. 

Port is downloading code. 

Fibre Channel 
Gigabit Ethernet 

Link configuration status is enabled. 
Link configuration status is disabled. 
Link operational status is up. 
Link operational status is down. 

Point-to-point 

1 Gb/s 

2 Gb/s 
Autonegotiate 

Default cost is inversely proportional to the speed. 
Link cost is 1 000. 
Link cost is 500. 

Link cost has a suffix of static. 
Displays the world wide name. 
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EX_Port 

Enabled 
Disabled 

Fabric ID 

Fabric params 

Front Phantom 

Pr Switch Info 

Licensed 
YES 
NO 

Diag Result 

PASSED 

FAILED 
Protocol 



The port is configured to be an EX_Port. 

No EX Port is displayed if the port is not configured to be 
an EX_Port. 

The fabric ID assigned to this EX_Port, which is the edge 
fabric attached to this EX_Port. 

The fabric parameters for port negotiation with the 
neighbor E Port in the EX Port-attached edge fabric. 
Fabric parameters include R_A_TOV, E D TOV, and Port 
ID format. 

Front phantom domain information presented by the 
EX_Port, including the preferred (nonactive) or actual 
(active) domain ID and WWN for the front domain. 

Information on the principal switch of the edge fabric 
attached to the EX Port, including the domain ID and 
WWN of the principal switch. 

Port is licensed. 

Port has failed diagnostics. 

Port has passed diagnostics. 
Port has failed diagnostics. 

Applies only to GbE ports. The supported protocol is FCIP. 



Operands 



Examples 



This command has the following required operand: 
port Specifies the port. 

To display information about port 1 , which is in point-to-point mode: 



swi tch : admin> 


portshow 1 




port 


1 info 






Configuration 


Current 


Name : 


port_l 




State: 


STARTED 


UP 


Type : 


FC 


FC 


Link Status : 


ENABLED 


UP 


Topology: 


P-P 


P-P 


Speed: 


AN 


2G 


LinkCost : 


800 (STATIC) 




WWN: 


20:01:00:05:le 


13:55:00 


Licensed 


: YES 




(continued on 


next page) 
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Dia-Q" result 


: PASSED 




inFira.ines : 


0 




nn 1~PT";=5Tnp'=; • 


0 




inOctets : 


0 




outOctets : 


0 




discards : 


0 




i\j uiokJiLJy 1 M 1 vji M 1 ivji 1 


Uk^^Ul L^LJi 1 ^/ WlllL.ll 




switch ; adiriin> 


portsliow 2 




port 


2 info 






Configuration 


Current 


Name : 


port 2 




State : 


STARTED 


UP 


Tvioe 


GIGE 


GIGE 


Link Status : 


ENABLED 


UP 


IP addr : 


10.50.50.2 


10.50.50.2 


Net mask: 


255.255.255.0 


255.255.255.0 


Default route 


10.50.50.0 


10.50.50.0 


Mac address : 


00:05:le:31:29 


:92 


Protocol : 


fcip ver 1 


fcip ver 1 


Licensed 


: YES 




Diag result 


: PASSED 





To display information about port 2, which is an EX Port: 



switch : admin> portshow 2 




port 


2 info 






Configuration 


Current 


Name : 


port_2 




State : 


STARTED 


UP 


Type : 


FC 


FC 


Link Status: 


ENABLED 


UP 


Topology: 


P-P 


P-P 


Speed: 


AN 


2G 


(continued on next 


page) 
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LinkCost : 


AUTO 500 


WvviN . 


ZU. U Z .UU . UD. ±e.-Lj . U-5 .uu 


Jzj A irUX L rlUClfc; . 


Ji 1 1 c± iJ -L fc; U. 


rciJjIlC ±JJ . D 




Fabric params : 


R_A_TOV: 10000 E_D_TOV: 2 000 PID f Itlt : COre 


Front Phantom : 


Dom ID: 3 WWN: 5 0 : 0 0 : 51 : el : 3 0 : 3 0 : Oe : 02 


Pr Switch Info : 


Dom ID: 2 WWN: 1 0 : 0 0 : 0 0 : 6 0 : 69 : cO : 2 0 : ed 


Licensed 


: YES 


Diag result 


: PASSED 


n TP "K" ^ Tn ^ c ■ 


Q 9 9 1 Ann 

O Z Z J- U / 


outFnraniss : 


0 9 9 9 0 0 9 
o Z Z Z o U Z 


inOctets : 


5469644108 


outOctets : 


11598160236 


discards : 


0 



See also 

linkCost 

portCfgEPort 

portCfgEXPort 

portCf gGige 

portCf gSpeed 

portCf gTopology 

portDisable 

portEnable 

portStart 

portStop 

portType 

switchShow 
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portStart 

Starts a port. 

Synopsis 

portStart port 

Availability 

admin 

Description 

Use this command to start a port. This command loads the port code, unlike the portEnable command, 
which enables the port laser. 

Operands 

This command has the following required operand: 
port Specifies the port. 

Examples 

To start port 3: 

switch :adinin> portStart 3 
port 3 started 

To start ports 3 through 6: 

switch :adinin> portStart 3-6 
port 3 started 
port 4 started 
port 5 started 
port 6 started 



See also 

portDisable 

portEnable 

portShow 

portStop 

portType 

switchShow 
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portStatsShow 

Displays port counters. 

Synopsis 

portstatsshow port 

Availability 

all users 

Description 

Use this command to display port counters. 

Operands 

This command has the following required operand: 
port Specifies the port. 

Examples 

To display counters for port 1 : 



swi tch : admin> 


portstatsshow 1 






Port 1 Counters 






Class 2 Counters 


Class 3 Counters 


inFrames : 


0 


inFrames : 


4268 


outFrames : 


0 


outFrames : 


1567 


inOctets : 


0 


inOctets : 


5338532 


outOctets : 


0 


outOctets : 


97320 


Class F Counters 


Error Counters 




inFrames : 


0 


Delimiter : 


0 


outFrames : 


0 


TxCreditZero : 


0 


inOctets : 


0 


insideFrame : 


0 


outOctets : 


0 


OutsideFrame : 


0 


discards : 


0 






r j tFrames : 


0 






bsyFrames : 


0 






FC Software 


Counters 






anyCrc : 


0 


badCrc : 0 




badPriSeq: 


0 


badTxWords : 2 0 




lossOf Sync : 


4 


linkFailure: 37 





See also 

portShow 
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portStop 

Stops a port. 

Synopsis 

portstop port 

Availability 

admin 

Description 

Use this command to stop a port. This command unloads the port code, unlike the portDisable 
command, which disables the port laser. 

Operands 

This command has the following required operand: 
port Specifies the port. 

Examples 

To stop port 3: 

switch :adinin> portstop 3 
port 3 stopped 

To stop ports 3 through 6: 

switch :adinin> portstop 3-5 
port 3 stopped 
port 4 stopped 
port 5 stopped 
port 6 stopped 



See also 



portDisable 

portEnable 

portShow 

portStart 

portType 
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portType 

Displays or sets the configured port type. 

Synopsis 

porttype port [porttype] 

Availability 

admin 

Description 

Use this command to display or set the configured port type. If the porttype parameter is given, the 
command sets the port to the specified new port type; otherwise, it displays the currently configured port 
type- 
Operands 

The optional porttype parameter is defined as: 

f Fibre Channel 

g Gigabit Ethernet 

r2^^ NOTE: See portCf gGige and portCf gEXPort for additional port configuration information. 



Examples 

To display the configured type of port 8: 

switch: admin> porttype 8 
Port 8 type is: GIGE 

To set the type of port 8 to Fibre Channel: 

switch: admin> porttype 8 f 
port 8 set to type FC 

To display the types of ports 7 through 9: 

switch: admin> porttype 7-9 
Port 7 type is: FC 
Port 8 type is: GIGE 
Port 9 type is: FC 

See also 

portCfgEXPort 
portCf gGige 
portShow 
portStart 
portStop 
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Displays processes status. 

Synopsis 

ps [-acCehjKlmrSTuvwx] [-K core] [ -N system] [-0 fmt] [-o fmt] [-p pid] 
[-t tty] [-V username] [-W swap] 

ps [-L] 



Availability 

admin 



Description 

Use this command to display a header line followed by lines containing information about processes that 
have controlling terminals. This information is sorted by controlling terminal and, among processes with 
the same controlling terminal, process ID. 

The information display is based on a set of selected keywords (see the -L, -o, and 

-o operands). The default output format for each process includes the process ID, controlling terminal, 

CPU time (including both user and system time), state, and associated command. 

Operands 

The operands are as follows: 

-a Displays information about other users' processes, as well as your own. 

-c Does not display the full command and arguments; displays only the 

executable name. This can be somewhat confusing; for example, all sh 
scripts are displayed as sh. 

-C Changes the way the CPU percentage is calculated by using a raw CPU 

calculation that ignores res/c/en/ time (this normally has no effect). 

-e Displays the environment. The environment for other users' processes can 

be displayed only by the superuser. 

-h Repeats the information header as often as necessary to guarantee one 

header per page of information. 

-j Displays information associated with the keywords: user, pid, ppid, 

pgid, sess, jobc, state, tt, time, and command. 

-K Disables the fallback /proc-based method. Note that the /proc-based 

method is used only if the ordinary kvm method is not possible. 

-L Lists the set of available keywords. 

-1 Displays information associated with the following keywords: uid, pid, 

ppid, cpu, pri, nice, vsz, rss, wchan, state, tt, time, and 
command. 

-M core Extracts values associated with the name list from the specified core 

instead from the default /dev/kmem file. The -M option implies the -K 
option. 

-m Sorts by memory usage instead of by process ID. 

-N system Extracts the name list from the specified system instead of from the 

default/netbsd file. 
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-O fmt Adds the information associated with the space- or comma-separated list 

of keywords specified after the process ID in the default information 
display. Keywords might be appended with an equal sign (=) and a 
string, causing the printed header to use the specified string instead of 
the standard header. 

-o fmt Displays information associated with the space- or comma-separated list 

of keywords specified. Keywords might be appended with an equal sign 
(=) and a string, causing the printed header to use the specified string 
instead of the standard header. 

-p pid Displays information associated with the specified process ID. 

-r Sorts by current CPU usage instead of by process ID. 

-S Changes the way the process time is calculated by summing all exited 

children to their parent process. 

-T Displays information about processes attached to the device associated 

with the standard input. 

-t tty Displays information about processes attached to the specified terminal 

device. Use a question mark (?) for processes not attached to a terminal 
device and a minus sign (-) for processes that have been revoked from 
their terminal device. 

-U username Displays processes belonging to the user whose user name or UID has 

been given to the -U switch. 

-u Displays information associated with the following keywords: user, pid, 

%cpu, %mem, vsz, rss, tt, state, start, time, and command. The 
-u option implies the -r option. 

-V Displays information associated with the following keywords: pid, 

state, time, si, re, pagein, vsz, rss, lim, tsiz, %cpu, %mem, 
and command. The -v option implies the -m option. 

-W swap Extracts swap information from the specified file instead of from the 

default /dev/drum file. 

-w Uses 1 32 columns to display information instead of the default, which is 

your window size. If the -w option is specified more than once, ps uses 
as many columns as necessary, without regard for your window size. 

-X Displays information about processes without controlling terminals. 

If the ps command cannot extract process information directly from the kernel (for example, due to an 
incorrect -N option or kvm-based reasons), it currently uses an experimental fallback method to gather as 
much information as possible through the limited interface if the /proc file system is mounted. (See 
mount_procf s for more details.) The ps command verifies that /proc is a proofs file system before 
proceeding. The -K option disables this fallback /proc-based lookup. 

The following is a complete list of available keywords: 

%CPU The CPU utilization of the process; this is a decaying average over up to a 

minute of previous (real) time. Because the time base over which this is 
computed varies (since processes might be extremely recent), it is possible for 
the sum of all %CPU fields to exceed 1 00 percent. 

%mem The percentage of real memory used by this process. 

flags The flags (in hexadecimal) associated with the process, as in the include file 

sys/proc .h: 1 -column P_NOCLDSTOP P_NOCLDSTOP . 

P_ADVLOCK 0x0000001 Process may hold a POSIX advisory 

lock. 

P_CONTROLT 0x0000002 Process has a controlling terminal. 
P_INMEM 0x0000004 Process is loaded into memory. 
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p_ 


_NOCLDSTOP 


0x0000008 


No P_NOCLDSTOP when children stop. 


p_ 


_PPWAIT 


0x0000010 


Parent is waiting for child to exec/exit. 


p_ 


_PROFIL 


0x0000020 


Process has started profiling. 


p_ 


_SELECT 


0x0000040 


Selecting; wakeup/waiting danger. 


p_ 


C XATITTD 
_bliN IK 


uxuuuuuou 


Sleep is interruptible. 


P_ 


_bULrlD 


UXUUUU 1 uu 


Process had set ID privileges since last 








exec. 


P_ 


_SYSTEM 


UxUUUUzUU 


System process: no sigs, stats or 








swapping. 


P 


TIMEOUT 


0x0000400 


Timina out durina s eeo 


P_ 


_TKALi1jU 


UXUUUUoUU 


Process is being traced. 


P_ 


_WAITED 


UxUUU 1 uuu 


Debugging process has waited for 








child. 


P_ 


_WEXIT 


0x0002000 


Working on exiting 


P_ 


_EXEC 


uxuuu^uuu 


Process called execve. 


ir_ 


OTftTtPTT'D^^ 

_UWEUr'U 


UXUUU ouuu 


\jyvQ process an a.aaupc \ ) can ai nexi 








3.S t . 


P_ 


_FSTRACE 


0x0010000 


Tracing through file system. 


P_ 


_NOCLDWAIT 


0x0020000 


No zombies when children die. 



lim The soft limit on memory used, specified through a call to setrlimit. 

Istart The exact time the command started, using the %C format described in 

strf time. 

nice The process scheduling increment (setpriority). 

rss The real memory (resident set) size of the process (in 1024-byte units). 

start The time the command started. If the command started less than 24 hours 

ago, the start time is displayed using the %1 : %M%p format described in 
strf time. If the command started fewer than 7 days ago, the start time is 
displayed using the %a%p format. Otherwise, the start time is displayed using 
the %e%b%y format. 

state The state is given by a sequence of letters: for example, RWNA. The first letter 

indicates the run state of the process: 

D Marks a process in disk (or other short-term, 

uninterruptible) wait. 

I Marks a process that is idle (sleeping for longer than 

20 seconds). 

R Marks a runable process. 

S Marks a process that is sleeping for less than 

20 seconds. 

T Marks a stopped process. 

z Marks a dead process (a zombie). 

Additional characters indicate other state information: 

+ The process is in the foreground process group of its 

control terminal. 

< The process has raised CPU scheduling priority. 

> The process has specified a soft limit on memory 

requirements and is currently exceeding that limit; such a 
process is (necessarily) not swapped. 



XPath OS 7.4.x command reference guide 21 1 



A The process has asked for random page replacement 

VA_A]NI0M from madvise (for example, a LISP interpreter 
in a garbage collection). 

E The process is trying to exit. 

K The process is a kernel thread or system process. 

L The process has pages locked in core (for example, for 

raw I/O). 

N The process has reduced CPU scheduling priority. 

S The process has asked for FIFO page replacement 

(VA_SEQL, from madvise, for example, a large image 
processing program using virtual memory to sequentially 
address voluminous data). 

s The process is a session leader. 

V The process is suspended during vf ork. 

W The process is sv/apped out. 

X The process is being traced or debugged. 

tt An abbreviation for the path name of the controlling 

terminal, if any. The abbreviation consists of the tv/o 
letters follov/ing /dev/tty, or for the console, co. This 
is followed by a - if the process can no longer reach 
that controlling terminal (for example, it has been 
revoked). 

wchan The event (an address in the system) on which a process 

waits. When printed numerically, the initial part of the 
address is trimmed off and the result is printed in 
hexadecimal; for example, 0x80324000 prints as 

324000. 

When printing using the command keyword, a process that has exited and has a parent that has not yet 
waited for the process (in other words, a zombie) is listed as <defunct>; a process that is blocked while 
trying to exit is listed as <exiting>. 

The ps command tries to locate the processes argument vector from the user area to print the command 

name and arguments. This method is not reliable, because a process is allowed to destroy this information. 
The ucomm (accounting) keyword always contains the real command name, contained in the process 
structure p_comm field. 

To indicate that the argument vector has been tampered with, ps appends the real command name to the 
output within parentheses if the base name of the first argument in the argument vector does not match the 
contents of the real command name. A special case is system processes and/or kernel threads that are 
shown within parentheses, because they do not set their argument vector. 

In addition, ps checks for the following two situations and does not append the real command name 
parenthesized: 

-shellname The login process traditionally adds a - in front of the shell 

name to indicate a login shell. The ps command will not append 
the parenthesized command name if it matches the name in the 
first argument of the argument vector, skipping the leading -. 

daemonname : Daemon processes frequently report their current activity by 

setting their name to be something such as daemonname: 
current-activity. The ps command does not append the 
parenthesized command name, if the string preceding the colon 
( :) in the first argument of the argument vector matches the 
command name. 
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Keywords 

The following list is a summary of all the available keywords and their meanings. Several of the keywords 
have aliases (synonyms). 



%cpu Percentage CPU usage (alias pcpu) 

%mem Percentage memory usage (alias pmem) 

acf lag accounting flag (alias acf Ig) 

command Command and arguments 

cpu Short-term CPU usage factor (for scheduling) 

flags The process flags, in hexadecimal (alias f) 

inblk Total blocks read (alias inblock) 

jobc Job control count 

holdcnt Number of holds on the process (if nonzero, process cannot be 

swapped) 

ktrace Tracing flags 

ktracep Tracing vnode 

lim Memory use limit 

logname Login name of user who started the process 

Istart Time started 

majflt Total page faults 

minf It Total page reclaims 

msgrcv Total messages received (reads from pipes/sockets) 

msgsnd Total messages sent (writes on pipes/sockets) 

nice Nice value (alias ni) 

nivcsw Total involuntary context switches 

nsigs Total signals taken (alias nsignals) 

nswap Total swaps in/out 

nvcsw Total voluntary context switches 

nwchan Wait channel (as an address) 

oublk Total blocks written (alias oublock) 

p_ru Resource usage (valid only for zombie) 

paddr Kernel virtual address of the struct proc belonging to the process. 

pagein Pageins (same as maj fit) 

pgid Process group number 

pid Process ID 

ppid Parent process ID 

pri Scheduling priority 

re Core residency time (in seconds; 127 = infinity) 

rgid Real group ID 

rlink Reverse link on run queue or 0 

rss Resident set size 

rsz Resident set size + (text size / text use count) (alias rssize) 

ruid Real user ID 

ruser User name (from ruid) 

sess Session pointer 
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sig 

sigcatch 

sigignore 

sigmask 

si 

start 

state 

svgid 

svuid 

tdev 

time 

tpgid 

tsess 

tsiz 

tt 

tty 

ucomm 

uid 

upr 

user 

vsz 

wchan 

xstat 

Files 

/dev 

/dev/driom 

/dev/kmem 

/ var / run / dev . db 

/ var / db / kvm . db 

/netbsd 

/proc 

See also 

none 



Pending signals (alias pending) 
Caught signals (alias caught) 
Ignored signals (alias ignored) 
Blocked signals (alias blocked) 
Sleep time (in seconds; 12 7 = infinity) 
Time started 

Symbolic process state (alias stat) 
Saved gid from a setgid executable 
Saved uid from a setuid executable 
Control terminal device number 

Accumulated CPU time, user + system (alias cputime) 
Control terminal process group ID 
Control terminal session pointer 
Text size (in KB) 

Control terminal name (tv/o letter abbreviation) 
Full name of control terminal 
Name to be used for accounting 
Effective user ID 

Scfieduling priority on return from system call (alias usrpri) 
User name (from UID) 
Virtual size in KB (alias vsize) 
Wait channel (as a symbolic name) 

Exit or stop status (valid only for stopped or zombie process) 

Special files and device names 

Default swap device 

Default kernel memory 

/dev name database 

System namelist database 

Default system namelist 

File system for obtaining process information 
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psShow 

Displays power supply status. 

Synopsis 

psshow 

Availability 

all users 

Description 

Use this command to display current status for all power supplies in the system. The number of power 
supplies might vary by chassis type. The same information is also provided by the chassisShow 
command. 

The power supply status messages include: 
OK 

FAIL 

NOT_PRESENT 

Operands 

none 

Examples 

To display the power supply status: 

switch : adinin> psshow 

POWER SUPPLY 1 Serial no : 12037S1025 Rev:0 Status: OK 
POWER SUPPLY 2 Status: NOT_PRESENT 

See also 

chassisShow 
f anShow 

switchStatusShow 
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quit 

Terminates the shell. 

Synopsis 

quit 

Availability 

all users 

Description 

This command terminates the shell. The user is logged out of the MP Router. 
Operands 

none 

Examples 

To log out of the MP Router: 

switch : admin> quit 

See also 

exit 
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reboot 

Executes a customized reboot command. 

Synopsis 

reboot 

Availability 

admin 

Description 

Use this command to invoke a series of actions to shut down ports and other MP Router software 
components before the MP Router calls the reboot command. 

Operands 

none 

Examples 

To execute the reboot procedure: 

switch : adinin> reboot 

Do you really want to reboot the switch (y, n) y 

See also 

f astBoot 
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rnPing 

Sends IP ping packets through an individual port. 

Synopsis 

rnping port destinationlpAddress [-1 sendBufferSize] 
[-n numOfEchoReqs] [-w timeout] 

Availability 

admin 

Description 

Use this command to send ICMP ECHO_REQUEST packets to network hosts through a specific GbE port. 
This command performs an IP ping (from a port configured to be in the IP mode) to a remote IP address. 

"252>f NOTE: Use the rnPing command to ping remote IP addresses only, not local IP addresses. 



Operands 

This command has the following required operand: 

port-param destinationlpAddress Specifies the IP address of the destination host and the 

port through which the ICMP ECHO_REQUEST packets 
will be sent. 

This command has the following optional operands: 

-1 sendBufferSize Sets the send buffer size. 

-n numOfEchoReqs Sets the number of echo requests. 

-w timeout Sets the timeout, in seconds, to wait for each reply. 

Examples 

To send ICMP ECHO_REQUEST packets to network host 192.168.10.1 through GbE port 3: 

switch : admin> rnping 3 192.168.10.1 

See also 

portCf gGige 
portType 
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routeShow 

Displays IP static route configuration. 

Synopsis 

routeshow 

Availability 

all users 

Description 

Use this command to display IP static route configuration. 

Operands 

none 

Examples 

To display IP static route configuration: 



switch : adinin> routeshow 






Routing tables 








Internet : 








Destination 


Gateway 




Flags 


default 


10.33.48.1 




UG 


10.20.0.0 


link* 3 




U 


10.33.32.0 


link#l 




U 


10.33.48.1 


00:00:0c:07 


ac:01 


UH 


10.33.63.39 


00:0b:db:90 


37 :b9 


UH 


loopback 


127 .0.0.1 




UGR 


localhost 


127 .0.0.1 




UH 


Persistent Routes 








Destination 


Gateway 




Net Mask 





See also 

none 
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secAuthSecret 



Manages DH-CHAP secret key information. 



Synopsis 



secauthsecret [--show] [--set] [--remove <www \ domain \ switch_name> \ --all ] 



Availability 

admin 



Description 

Use this command to display, set, or remove secret key information from tfie DH-CHAP stiared secret key 
database, which is used for authentication, or to delete the entire database. When you perform a set or 
remove operation, after the command has completed, nev/ data is saved persistently and becomes 
effective v/ith the next authentication request on the port. 



Operands 



This command has the follov/ing optional operands: 



-show 



-set 



--remove <www 
switch_name> \ 



domain 
--all 



Lists the WWNs for v/hich a shared secret is 
configured. 

Sets up shared secrets v^ith a WWN. 

Removes the specified WWN entry from the database. 
If a domain name is specified, it is converted to a 
WWN and then the entry is removed. If --all is 
specified, the entire database is removed. If the 
operand is omitted, the command enters interactive 
mode. 



Examples 



To display the shared secret key database: 



fcr:adinin> secauthsecret 


--show 




WWN 


Did 


Name 


10:00:00:60:69:80:5b:e8 


1 


switch 
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To set a shared secret key: 



fcr:aditiin> secAuthSecret --set 

This command sets up secret keys for the DH-CHAP authentication. 
The minimum length of a secret key is 8 characters and maximum 40 
characters. Setting up secret keys does not initiate DH-CHAP 
authentication. It is performed whenever a port or a switch is enabled. 

Following inputs should be specified for each entry. 

1. WWN for which secret is being set up. 

2. Peer secret: The secret of the peer that authenticates to peer. 

3. Local secret: The local secret that authenticates peer. 



Press Enter to start setting up shared secrets > 



Enter WWN, Domain, or switch name (Leave blank 
10:00:00:60:69:80:05:14 


when done) : 


Enter peer secret: 




Re-enter peer secret: 




Enter local secret: 




Re-enter local secret: 




Enter WWN, Domain, or switch name (Leave blank 


when done) : 


Are you done? (yes, y, no, n) : [no] y 




Saving data to key store... Done. 




To remove all shared secret keys: 


f or : admin> secAuthSecret --remove --all 




This command deletes database of DH-CHAP secret 


keys. If a fabric 


requires authentication, deleting this database 


may cause switch 


to segment from the fabric . 




Do want to remove secret key database? (yes, y. 


no, n) : [no] y 


Deleting secret key database... Done. 





See also 

none 
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serviceCfg 

Manages the iSCSI application service on the switch. 

Synopsis 

servicecfg [-e serviceBitMap] [-d serviceBitMap] 

Availability 

admin 

Description 

Use this command to enable and disable a particular service. 

Operands 

This command has the following optional operands: 

-d serviceBitMap Disables a service, 

-e serviceBitMap Enables a service. 

If no operand is specified, the command displays the current status of all application services. 

Examples 

To enable the iSCSI service: 

switch : admin> servicecfg -e iSCSI 
iSCSl service is enabled. 

See also 

none 
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setFanSpeed 

Sets the fan speed for all fans. 

Synopsis 

setfanspeed [0|1] 

Availability 

admin 

Description 

Use tfiis command to set tfie speed of all fans to one of two speeds. If a temperature sensor exceeds the 
warning threshold, this command fails because the system automatically sets the fan speed to HIGH. 

Operands 

This command has the following operands: 

0 Sets the speed for all fans to NORMAL. 

1 Sets the speed for all fans to HIGH. 

Examples 

To set the fan speed: 

switch :adinin> setfanspeed 1 
Fan speed is set to HIGH 

See also 

f anShow 
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setPagerOff 

Reverts to normal, nonpaginated screen output. 

Synopsis 

setpagerof f 

Availability 

all users 

Description 

Use this command to turn off paginated command output resulting from a previous setPagerOn 
command. Future command output continues v/itfiout pause, even if it exceeds the area visible in one 
screen. 

Operands 

none 

Examples 

To turn pagination off: 

switch : admin> setpagerof f 

See also 

setPagerOn 



224 XPath OS CLI commands 



setPagerOn 

Provides paginated screen output. 

Synopsis 

setpageron 

Availability 

all users 

Description 

Use this command to display subsequent command results one screen at a time, preventing them from 
exceeding the visible screen area. Press the Spacebar v/hen ready to read the next screen of output. 

Operands 

none 

Examples 

To turn pagination on: 

switch ;adinin> setpageron 

See also 

setPagerOf f 
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sfpShow 



Displays port SFP information. 



Synopsis 



sfpshow [port] 



Availability 

all users 

Description 

Use this command to display a summary of all port SFP information or detailed SFP information for a 
specific port. When a port is not specified, sfpShow displays SFP information for all ports. 



Operands 



Examples 



This command has the following optional operand: 
port Displays SFP information for the specified port only. 

To display SFP information about port 2: 



switch: admin> sfpshow 2 
Port 2 sfp data 



Identifier : 
Connector : 
Transceiver : 
Distance 
Encoding : 
Baud Rate: 
Length 9u: 
Length 50u: 
Length 62 5u: 
Length Cu : 
Vendor Name : 
Vendor OUI : 
Vendor PN: 
Vendor Rev: 
Options : 
Enh Options : 
BR Max: 
BR Min: 
Serial No: 
Date Code: 



SFP 
LC 

100Mbps, 



200Mbps, M5, M6, SWLaser(SN), Intermediate 



8B10B 

21 (units 100 megabaud) 
0 (units 100 meters) 
30 (units 10 meters) 
13 (units 10 meters) 
0 (units 1 meter) 
FINISAR CORP. 
00:90:65 
FTRJ-8519-3-2 . 5 
XI 

0012 Tx Disable, Loss of Signal 

00 

0 

0 

E112CYQ 
010120 
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To display SFP information about ports 8 through 9: 



switch :adinin> sfpshow 8-9 



See also 



Port 8 sfp 


data 








Identifier : 


SFP 








Connector : 


LC 








Transceiver ; 


: 100Mbps, 2 0 0Mbps, M5, 


M6, 


SWLaser 


(SN) 


Encoding : 


8B10B 








Baud Rate : 


21 (units 100 megabaud) 






Length 9u: 


0 (units 100 meters) 








Length 50u: 


3 0 (units 10 meters) 








Length 62 5u; 


: 13 (units 10 meters) 








Length Cu : 


0 (units 1 meter) 








Vendor Name : 


: FINISAR CORP. 








Vendor OUI : 


00:90:65 








Vendor PN : 


FTRJ-8519-3-2 . 5 








Vendor Rev : 


XI 








Options : 


0012 Tx Disable, Loss 


of 


Signal 




Enh Options ; 


: 00 








BR Max: 


0 








BR Min: 


0 








Serial No: 


E112CYQ 








Date Code: 


010120 








Port 9 sfp 


data 








Identifier : 


SFP 








Connector : 


LC 








Transceiver ; 


: 10 0Mbps, 2 00Mbps, M5, 


M6, 


SWLaser 


(SN) 


Encoding : 


8B10B 








Baud Rate : 


21 (units 100 megabaud) 






Length 9u: 


0 (units 100 meters) 








Length 50u: 


30 (units 10 meters) 








Length 62 5u: 


: 13 (units 10 meters) 








Length Cu : 


0 (units 1 meter) 








Vendor Name ; 


: FINISAR CORP. 








Vendor OUI : 


00:90:65 








Vendor PN: 


FTRJ-8519-3-2 . 5 








Vendor Rev : 


XI 










0012 Tx Disable, Loss 


of 


o 1 y ITo. J_ 




Enh Options ; 


: 00 








BR Max: 


0 








BR Min: 


0 








Serial No: 


E1127M1 








Date Code: 


010121 









sfpSupport 
switchShow 



XPath OS 7.4.x command reference guide 227 



sfpSupport 

Displays a list of supported SFPs. 

Synopsis 

sfpsupport 

Availability 

all users 

Description 

Use this command to display a list of supported SFPs. 

Operands 

none 

Examples 

To display a list of supported SFPs: 

switch: admin> sfpsupport 

See also 

none 
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showRecovery 

Displays the recovery kernel version stored in bonkO. 

Synopsis 

showrecovery 

Availability 

all users 

Description 

Use this command to display the version of the recovery kernel softv/are stored in bankO. 

Operands 

none 

Examples 

To display the recovery kernel version: 

switch : ac3inin> showrecovery 
Recovery Kernel version : 1.3. 0.0 

See also 

sfpSupport 
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spinSilk 



Tests both the wire-side and crossbar-side port operations. 



Synopsis 

spinsilk [-p port_list] [-n frame_count] [-1 length] [-s speed] [-mmac] 
[ -b loopback] 



Use this command to test both the wire-side and crossbar-side port operation. This test generates one 
frame from one port and sends it to the wire. Depending on the wire-side loopback mode, this frame 
arrives either at the same port or at a port to which it is connected through the wire. Then the frame is 
forwarded to the crossbar. Depending on the crossbar-side loopback mode, the frame arrives either at the 
same port or at another port through the crossbar. Afterward, the frame is sent to the wire again. 

Inside the wire and crossbar loop, only one frame travels at a time. The wire receiver stops forwarding the 
frame to the crossbar when the maximum number of frames or passes has been reached. 

All ports involved in the test must be diagnostics-enabled prior to running this test. 



Availability 



admin 



Description 



Operands 



This command has the following optional operands: 



-1 length 



-m mac 



-n frame_count 



■p port_list 



s speed 
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-b loopback Specifies the loopback mode. The default is 2 (Wire internal loop 

back. Crossbar back to itself). The term partner means a pairing of 
the participating ports. If an odd number of ports is involved, the 
last participating port will loop back to itself in crossbar. The term 
chain means that all participating ports form one single loop, 
including both wire side and crossbar side. 



2 Wire internal loopback. Crossbar back to itself. 

3 Wire internal loopback. Crossbar to its partner. 

4 Wire internal loopback. Crossbar forms a chain. 

5 Wire external loopback. Crossbar to itself. 

6 Wire external loopback to itself. Crossbar forms a 
chain. 



Examples 

To send 1024 frames from ports 1 2 and 1 3 to the wire in Fibre Channel mode and loop them back to 
themselves on both the wire and the crossbar sides: 



switch:admin> spinsilk -p 12-13 -n 1024 -1 2048 
spinsilk -p 12-13 -n 1024 -1 2048 -b 2 -s 2 -m 0 
Port Tx fr Tx bytes Rx fr Rx bytes 


Deli 


Size 


In 


Out 


RSLT 


OOOC 00000401 00000020781C 00000401 00000020781C 
OOOD 00000401 00000020781C 00000401 00000020781C 


0000 
0000 


0000 
0000 


0000 
0000 


0000 
0000 


PASS 
PASS 


To send 1024 frames from ports 1 2 and 1 3 to the wire in Ethernet mode 
themselves on both the wire and crossbar sides: 


and loop them 


back to 




switch :adinin> spinsilk -p 12-13 -n 1024 -1 1024 -m 1 
spinsilk -p 12-13 -n 1024 -1 1024 -b 2 -s 2 -m 1 
Port Tx fr Tx bytes Rx fr Rx bytes 


CrcT 


CrcR 


BadT 


BadR 


RSLT 


OOOC 00000401 000000104C12 00000401 000000104C12 
OOOD 00000401 000000104C12 00000401 00000104C12 


0000 
0000 


0000 
0000 


0000 
0000 


0000 
0000 


PASS 
PASS 



See also 

crossPortTest 



portDiagDi sable 

portDiagEnable 

portLoopbackTest 
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supportShow 

Runs the CLI scripts for debugging. 

Synopsis 

supportshow 

Availability 

admin 

Description 

Use this command to run CLI scripts, which are generally used for debugging. Commands include the 
following: 



chassisShow 


f crProxyDevShow 


portCf gShow 


cfgActvShow -d 


f crResourceShow 


portLogDump 


cf gShow 


f crRouteShow 


portRouteInf o 


conf igShow 


f crXlateConf ig 


portShow 0-15 


date 


f igeroShow 


portStatsShow 0-15 


du 


f spf Show 


ps-axl 


dlsShow 


ifConfig -a 


psShow 


errShow -a 


interf aceShow 


routeShow 


eventShow 


iodShow 


sfpShow 


eventShowByNum 1 -1 -a 


ipaddrShow 


shpShow 1-15 


f abLogShow 


licenseShow 


slotShow 


f abricShow 


IsanZoneShow 


switchShow 


f azoneAdd 


IsdbShow 


tempShow 


fcipShow 0-15 


nbrStateShow 


top -d 1 


f crDbgDevShow 


nsAllShow -V 


topologyShow 


f crFabricShow 


nslogShow 


uname 


f crLogShow 


nsShow 


upTime 


f crPhyDevShow 


portCfgEXPort 0-15 


urouteShow 


f crProxyConf ig 


portCfgFcip $1 


zslogShow 



The output from the scripts is displayed on the screen. The display can also be saved in a file with an 
extension of . log or . txt. 

Examples 

To display the output on the screen: 

switch: admin> supportshow 
To save the output to a log file: 

switch : admin> supportshow > logfile.txt 

See also 

diagUpload 
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svipAddrSet 

Sets the virtual management IP configuration of the MP Router. 

Synopsis 

svipaddrset -i ipAddress -n netMask -a action 

Availability 

admin 

Description 

Use this command to set the virtual management IP configuration. The virtual management IP address is 
used as the single identity of the MP Router. 

Configuration scenario I: If the secondary management interface is not used, the virtual management IP 
configuration is set the same as the primary IP configuration by default. 

Configuration scenario II: If both management interfaces are configured in the same subnet, the virtual 
management IP configuration must be configured v/ithin the same subnet. 

I^if NOTE: The virtual management IP configuration is set to the same value as the primary IP configuration 
by default. It also can be changed using ipaddrSet -s. 



Operands 

The following operands are required: 

-i ipAddress Sets the IP address in the standard aa.bb.cc.dd format. 

-n netMask Sets the netmask in the standard aa.bb.cc.dd format. 

-a action Specifies whether the change takes effect immediately (cfgnow) 

or after next reboot (cfgafterreboot). 

Examples 

To set virtual management IP address 192.168.10.1 and netmask 255.255.255.0: 

switch :admin> svipaddrset -i 192.168.10.1 -n 255.255.255.0 -a cfgnow 

See also 

ipaddrSet 

ipaddrShow 

svipAddrShow 
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svipAddrShow 

Displays the virtual management IP configuration of the MP Router. 

Synopsis 

svipaddrshow 

Availability 

all users 

Description 

Use this command to display the virtual management IP configuration of the MP Router. 

Operands 

none 

Examples 

To display the virtual management IP configuration of the MP Router: 



switch : admin> svipaddrshow 








The switch virtual IP 


configuration 


current 




IP address 


10.33.58.20 


10.33 .58 


! .20 


Netmask 


255.255.224.0 


255 .255 


224 . 0 


Gateway 




10.33.4f 


i . 1 



See also 

svipAddrSet 
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switchDisable 



Disables the whole MP Router. 

Synopsis 

switchdisable [-f] 

Availability 

admin 

Description 

Use this command to disable an MP Router and all its ports. No ports can be individually enabled by the 
portEnable command until the MP Router itself is enabled. 

If a switchDisable command is in progress, you cannot issue another switchDisable or 
switchEnable command. If the previously issued command never completes, use the -f operand. The 
MP Router ignores the state of the previously issued command and attempts to perform the operation as 
well as possible. 

Operands 

The following operand is optional: 

-f Forces the MP Router to be disabled. 

Examples 

To disable the MP Router: 

switch : adinin> switchdisable 

switch is being disabled 

Switchdisabled 

See also 

configure 

switchEnable 

switchShow 
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switchEnable 



Enables the whole MP Router. 

Synopsis 

switchenable [-f] 

Availability 

admin 

Description 

Use this command to allow ports to be enabled. If an MP Router is disabled, all its ports are disabled. 
However, if an MP Router is enabled, any individual port can still be disabled by a portDisable 
command. 

If a switchEnable command is in progress, you cannot issue a switchDisable command or another 
switchEnable command. If the previously issued command never completes, use the -f operand. The 
MP Router ignores the state of the previously issued command and attempts to perform the operation as 
well as possible. 

Operands 

The following operand is optional: 

-f Forces the MP Router to be enabled. 

Examples 

To enable the MP Router: 

switch : admin> switchenable 
Switch Enabled 

See also 

configure 

switchDisable 

switchShow 
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switch Name 



Displays and sets the MP Router name. 

Synopsis 

switchname [switch-name] 

Availability 

admin 

Description 

Use this command to display and set the MP Router name. If you enter the command without an operand, 
the MP Router name is displayed. The MP Router name is displayed also in the user interface prompt. 

The MP Router name is a maximum of 19 characters, including letters, digits, underscores, and spaces; it 
must start with either a letter or a digit. 

Operands 

The following operand is optional: 

switch-name Sets the MP Router name. 

Examples 

To display the MP Router name: 

switch :adinin> switchname 

To set the MP Router name: 

switch : adinin> switchname newswitchname 
newswitchname : adinin> 

See also 

switchShow 
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switchShow 

Displays MP Router and port status. 

Synopsis 

switchshow 

Availability 

all users 

Description 

Use this command to display MP Router and port status information. This command displays the following 
fields: 

Switch Name The symbolic name 

Switch State The MP Router state: online or offline 

Switch Type The MP Router model an revision numbers 

Switch Role The MP Router role: principal or subordinate 

Switch Domain The MP Router Domain ID: 1 to 23 9 

Switch ID The MP Router embedded port DJD 

Switch WWN The MP Router world wide name 

beacon status The MP Router beacon status 

zoning The MP Router zoning status 

MP Router BB Fabric The backbone fabric ID for FC routing 

ID 

The MP Router summary is followed by one line per port, as follows: 
Port The port number 

Media -- No module present 

id Serial ID 

Speed IG 1 Gb/s 

2G 2 Gb/s 

Nl 1 Gb/s negotiation 

N2 2 Gb/s negotiation 

AN Autonegotiation 

State No_Module No module present (SFP or other) 

No_Light The module is not receiving light 

Online The port is up and running 

Info The Info field can be blank or display the 

following : 

E_Port Fabric port 

F_Port Point-to-point 

FL_Port Loop port 

EX_Port EX_Port 

VE_Port FCIP port 

disabled Port is disabled 

loopback Port is in loopback mode 
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stopped Post is stopped 

invalid sfp SFP module is not supported 

diagnostic Port is in diagnostic mode 

The Info field also might display error information associated with the port, for example: 

Last error Exceeded max number of zone resources. 

This error implies that the zoning information has exceeded the switch resources. The maximum number of 
devices is 10,000 and the maximum number of zone groups is 3,000. The eventShow command 
provides more details about the error. 

Operands 

none 



Examples 

To display the MP Router and port status: 



switch 


: admin> 


switchshow 












Switch 


Name 




switch 












Switch 


State 




Online 












Switch 


Type 




38. 


0 












Switch 


Role 




Subordinate 












Switch 


Domain 




103 














Switch 


ID 




FFFC67 












Switch 


WWN 




10: 


00:00:05:le 


:12:e7:00 










beacon 


Status 




OFF 














zoning 






ON 


(zsl) 












FC router BB 


Fabric 


ID: 1 












Port 


Media 


Speed 


State 


Info 










0 


id 


m 




No_Light 












1 


id 


m 




No_Light 












2 


id 


m 




Online 












3 


id 


N2 




Online 


EX_PORT 10:00:00 


: 60 


:69:90 


:10:ba 


"switch2" (fabric id = 2 ) 


4 


id 


N2 




Online 


E_PORT 10:00:00: 


60 : 


69:90: 


10:dc ' 


tombrocadell " (upstream) 


5 


id 


m 




No_Light 


Disabled 










6 


id 


AN 




Online 












7 




AN 




No_Module 












8 


id 


Nl 




Online 


VE_PORT 10:00:00 


: 05 


:le:12 


:fa:00 


"tommars4" (downstream) 


9 


id 


AN 




No_Light 


Disabled 










10 


id 


AN 




No_Light 












11 


id 


N2 




Online 


F_PORT 10:00:00: 


00 : 


c9:33: 


3e:3f 




12 


id 


AN 




No_Light 












13 


id 


2G 




No_Light 












14 


id 


AN 




No_Light 












15 


id 


Nl 




Online 


L_PORT 7 public 
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See also 

conf igShow 

configure 

eventShow 

switchDi sable 

switchEnable 

switchName 
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switchStatusShow 

Displays the overall status of the MP Router. 

Synopsis 

switchstatusshow 

Availability 

all users 

Description 

Use this command to display the overall status of the MP Router, as determined by the overall status of the 
pov/er supply, fan, and temperature sensors. If any of them is in critical status, overall MP Router status is 
critical; if none of them is in critical status but one or more is in marginal status, the overall MP Router 
status is marginal. Otherv/ise, overall MP Router status is healthy. 

If the MP Router is disabled, the overall MP Router status is marginal. 

Operands 

none 

Examples 

To display the overall status of the MP Router: 



See also 



switch :admin> switchstatusshow 
Switch overall status: Marginal 
Reason: 




power supply is in MARGINAL state 




Power overall status: Marginal 
Fan overall status: Healthy 
Temp overall status: Healthy 




f anShow 



psShow 
tempShow 
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syslogdipAdd 

Adds the IP address of a syslog daemon. 

Synopsis 

syslogdipadd " ip Address" 

Availability 

admin 



Description 

The syslog daemon (syslogd) is a process available on most UNIX® systems that reads and forwards 
system messages to the appropriate log files and/or users, depending on the system configuration. This 
command adds the IP address of a syslog daemon, that is, the IP address of the server that is running the 
syslogd process. When one or more IP addresses are configured, the MP Router forwards all error-log 
entries (see errShow) to the syslogd on all the specified servers. Up to six servers are supported. 

Operands 

This command has the following required operand: 

" ipAddress" IP address of the syslog daemon (the server that is running the 

syslogd process). 

Examples 

To add the address 192.168.1 .60 to the list of machines to which system messages are sent: 

switch : admin> syslogdipaddr "192.158.1.60" 
syslog . IP . address 192.168.1.60 is added 



See also 

sys 1 ogdipRemove 
syslogdipShow 
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syslogdipRemove 



Removes the IP address of a syslog daemon. 

Synopsis 

syslogdipremove " ipAddress" 

Availability 

admin 

Description 

Use this command to remove the IP address of a syslog daemon (the server that is running the syslogd 
process) . 

Operands 

This command has the following required operand: 

"ipAddress" IP address of the syslog daemon (the server that is running the 

syslogdd process). 

Examples 

To remove the address 1 92. 1 68. 1 .60 from the list of machines to which system messages are sent: 

switch : ad[nin> syslogdipremove "192.168.1.60" 
syslog . IP . address 192.168.1.60 is removed 

See also 

sys 1 ogdipAdd 
syslogdipShow 
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syslogdipShow 

Displays all the syslog daemon IP addresses. 

Synopsis 

syslogdipshow 

Availability 

all users 

Description 

Use this command to display all the syslog daemon IP addresses in the configuration database. 

Operands 

none 

Examples 

To display all the syslog daemon IP addresses: 



switch: admin> syslogdipshow 










syslog . IP . address . 1 : 


192 


168 


. 1 


60 


syslog . IP . address . 2 : 


192 


168 


. 1 


88 


syslog . IP . address . 3 : 


192 


168 


.2 


77 



See also 

sys 1 ogdipAdd 
sys 1 ogdipRemove 
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tempShow 

Displays temperature sensor readings. 

Synopsis 

temp show 

Availability 

all users 

Description 

Use this command to display all temperature sensor readings. The number of sensors might vary among 
different platforms. Every sensor is indexed by a sequential number. The status of the sensor can be OK or 
Marginal. Both Centigrade and Fahrenheit readings are displayed. 

Operands 

none 

Examples 

To display all temperature sensor readings: 



switch 


admin> 


tempshow 




Index 


Status 


Centigrade 


Fahrenheit 


1 


OK 


32 


90 


2 


OK 


34 


93 


3 


OK 


40 


104 


4 


OK 


34 


93 


5 


OK 


37 


99 



See also 

f anShow 
psShow 
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timeout 

Displays or sets the IDLE timeout value for a login session. 

Synopsis 

timeout [timeVal] 

Availability 

admin 

Description 

Use this command without an operand to display the current IDLE timeout for the login session. 

Operands 

This command has the following optional operand: 

timeVal Sets the IDLE timeout value to number of minutes. Using a 

timeout value of 0 disables the timeout functionality; login 
sessions would never be disconnected. The maximum value that 
can be specified is 99, 999; the default is 10 minutes. 

Examples 

To set the idle timeout to 1 0 minutes: 

switch : admin> timeout 10 

IDLE Timeout Changed to 10 minutes 

The modified IDLE Timeout will be in effect after NEXT login. 



See also 

none 
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timeZoneSet 



Sets the local time zone for the MP Router. 

Synopsis 

timezoneset 

Availability 

admin 

Description 

Use this command to set the local time zone for the MP Router. 

Operands 

none 



Examples 

To set the local time zone to US/Pacific: 



switch : adinin> timezoneset 












Please select a continent 


or ocean 










1) . Africa 


2) . 


America 


3) . 


Antarctica 


4) . 


Arctic Ocean 


5) . Asia 


6) . 


Atlantic Ocean 


7) . 


Australia 


8) . 


Europe 


9) . Indian Ocean 


10) . 


Pacific Ocean 


11) . 


US 


12) . 


Canada 


Enter the option # : 


11 












Please select a country or city 










1) . Alaska 


2) . 


Aleutian 


3) . 


Arizona 


4) . 


Central 


5). East-Indiana 


6) . 


Eastern 


7) . 


Hawaii 


8) . 


Indiana- Starke 


9 ) . Michigan 


10) . 


Mountain 


11) . 


Pacific 


12) . 


Pacific-New 


13 ) . Samoa 














Enter the option #: 


11 












time zone is set 















See also 

date 
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top 

Displays and updates information about the top CPU processes. 

Synopsis 

top [-Sbilnquv] [-d count] [-s time] [-o field] [-U user] [number] 

Description 

Use this command to display the top 1 0 processes on the system and periodically update this information. 
If standard output is on an intelligent terminal (see below), then as many processes as will fit on the 
terminal screen are displayed by default; otherwise, approximately 20 are displayed. Raw CPU 
percentage is used to rank the processes. If number is given, then the top number processes are 
displayed instead. 

This command distinguishes between terminals that support advanced capabilities and those that do not. 
This distinction affects the choice of defaults for certain options. In the remainder of this document, an 
intelligent terminal is one that supports cursor addressing, clear screen, and clear to end of line. 
Conversely, a dumb terminal is one that does not support such features. If the output of the top command 
is redirected to a file, the command acts as if it were being run on a dumb terminal. 

Operands 

This command has the following optional operands: 

-S Toggles display of system processes. Normally, system processes such as 

the pager and the swapper are shown. 

-b Uses batch mode. In this mode, all input from the terminal is ignored. 

Interrupt characters (such as '^C and '^e) still have an effect. This is the 
default on a dumb terminal or when the output is not on a terminal. 

-i Uses interactive mode. In this mode, any input is immediately read for 

processing. See the section, "Interactive mode" on page 249 for an 
explanation of which keys perform what functions. After the command is 
processed, the screen is immediately updated, even if the command was 
not understood. This mode is the default when standard output is on an 
intelligent terminal. 

-I Does not display idle processes. By default, the top command displays 

both active and idle processes. 

-n Uses noninteractive mode. This is identical to batch mode. 

-q Changes the priority of top to -20 so that it will run faster. This can be 

used when the system is being very sluggish, to help discover the 
problem. This option can be used only by the root user. 

-u Does not map UID numbers to user names. Normally, top reads as much 

of the file /etc/passwd as is necessary to map all of the user ID 
numbers it encounters to login names. This option disables all that, while 
possibly decreasing execution time. The UID numbers are displayed 
instead of the names. 

-V Writes version number information to stderr and then exits 

immediately. No other processing takes place when this option is used. 
To see current revision information while top is running, use the help 
command (?). 

-d count Shows only count displays and then exits. A display is considered to be 

one update of the screen. This option allows users to select the number of 
displays they want to see before top automatically exits. For intelligent 
terminals, no upper limit is set. The default is 1 for dumb terminals. 
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-s time Sets the delay between screen updates to time seconds. The default 

delay between updates is nD seconds. 

-o field Sorts the process display area on the specified field. The field name is the 

name of the column as seen in the output, but in lowercase letters. Likely 
values are cpu, size, res, and time, but this might vary on different 
operating systems. Note that not all operating systems support this 
option. 

-U user Shows only those processes owned by user name. This option currently 

accepts only user names and will not understand UID numbers. 

number Sets the number of top processes to be displayed. 

Both the count and nuinJber operands can be specified as infinite, indicating that they can stretch as 
far as possible. This is accomplished by using any proper prefix of the keywords infinity, maximum, or 
all. The default for count on an intelligent terminal is infinity. 

The environment variable top is examined for options before the command line is scanned. This enables 
users to set their own defaults. The number of processes to display can also be specified in the environment 
variable top. The operands -i, -S, and -u are actually toggles. A second specification of any of these 
operands negates the first. Thus, a user who has the environment variable TOP set to -I can use the 
command top -I to display idle processes. 

Interactive mode 

When top is running in interactive mode, it reads commands from the terminal and acts upon them 
accordingly. In this mode, the terminal is put in CBREAK; a character is processed as soon as it is typed. 
Almost always, a key is pressed when top is between displays, that is, while it is waiting for time 
seconds to elapse. If this is the case, the command is processed and the display is updated immediately 
thereafter (reflecting any changes that the command might have specified). This happens even if the 
command was incorrect. 

If a key is pressed while top is updating the display, top finishes the update and then processes the 
command. Some commands require additional information, and the user is prompted accordingly. While 
typing this information, the user's erase and kill keys (as set up by the command stty) are recognized; a 
newline character terminates the input. 

These commands are currently recognized (^L refers to Ctrl-L): 

Redraws the screen. 

fBh or ? Displays a summary of the commands (help screen). Version 

information is included in this display. 

q Quits top. 

d Changes the number of displays to show (prompts for new 

number). Remember that the next display counts as one, so 
typing dl makes top show one final display and then 
immediately exit. 

n or # Changes the number of processes to display (prompts for new 

number). 

s Changes the number of seconds to delay between displays 

(prompts for new number). 

S Toggles between showing and not showing system processes. 

k Sends a signal (kill by default) to a list of processes. This acts 

similarly to the command kill. 

r Changes the priority (the nice) of a list of processes. This acts 

similarly to the command renice. 
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u 



i or I 



Displays only processes owned by a specific user name (prompts 
for user name). If the user name specified is simply +, processes 
belonging to all users are displayed. 

Cfianges tfie order in which the display is sorted. This command 
is not available on all systems. The sort key names vary from 
system to system but usually include cpu, res, size, and time. 
The default is cpu. 

Displays a list of system errors (if any) generated by the last 
kill or renice command. 

Toggles the display of idle processes. 



Display 



The actual display varies, depending on the specific variant of UNIX that the machine is running. 

The first few lines of the display show general information about the state of the system, including the last 
process ID assigned to a process (on most systems), the three load averages, the current time, the number 
of existing processes, the number of processes in each state (sleeping, running, starting, 
zombies, and stopped), and a percentage of time spent in each of the processor states (user, nice, 
system, and idle). It also includes information about physical and virtual memory allocation. 

The remainder of the screen displays information about individual processes. This display is similar to the 
output for portStop, but it is not exactly the same. 



PID 

USERNAME 

PRI 
NICE 
SIZE 
RES 

STATE 

TIME 

WCPU 



CPU 



COMMAND 



Process ID. 

Name of the process owner (if -u is specified, a UID column is 
substituted for username). 

Current priority of the process. 

Nice amount (in the range -20 to 20). 

Total size of the process (text, data, and stack). 

Current amount of resident memory (both SIZE and RES are 
given in kilobytes). 

Current state (one of START, RUN, STOP, ZOMB, DEAD, or CPU) 
or wait channel if the state is sleep. 

Number of system and user CPU seconds that the process has 
used. 

When displayed, the weighted CPU percentage (this is the same 
value that portStop displays as CPU). 

Raw percentage and is the field that is sorted to determine the 
order of the processes. 

Name of the command that the process is currently running (if 
the process is swapped out, this column is marked <swapped>). 



On multiprocessor systems, the state field might be followed by a slash and CPU number. 



Examples 



none 



See also 



none 
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topologyShow 



Displays the unicast fabric topology. 



Synopsis 



topology show [doinain_nuinber] 



Availability 

all users 



Description 

Use this command to display fabric topology as seen by the local MP Router. The fabric topology consists 
of a list of all domains that are part of the fabric and, for each of those domains, all the possible paths to 
reach the domain from the local MP Router. 

A path is defined by the output port that a frame, which has been addressed to a certain domain, is 
forwarded to by the MP Router routing hardware. 

In addition, this command displays the following for each path: its cost, the number of hops from the local 
MP Router to the destination switch, and the summary of all ports routed through that path. 



Local Domain ID 

Domain 

Metric 

Hops 

Out Port 
Name 



The domain number of the local MP Router. 

The domain number of the destination switch. 

The cost of reaching the destination domain. 

The maximum number of hops required to reach the destination 
domain. 

The port to which an incoming frame will be forwarded, in order 
to reach the destination domain. 

Switch name of the destination switch. 



Operands 



The following operand is optiona 

domain number 



The destination domain whose topology information is to be 
displayed. 



Examples 



To display the unicast fabric topology: 



switch : admin> topologyshow 






13 domains in the fabric; Local Domain 


ID: 50 


Domain Metric Hops Out 


Port 


Name 


54 1000 2 


0 


'■brcd_32 00_57_54" 




1 






4 






5 






6 




58 500 1 


12 


'■AP_57_58" 




13 






14 




(continued on next page) 
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70 


500 


1 


4 


■■brcd_3 800_57_7 0" 








5 










6 




71 


500 


1 


11 


■■bred 3800 32 71^^ 


73 


500 


1 


0 


■■brcd_12kl_57_73 ■■ 






1 






76 


1000 


2 


0 


■■brcd_32 0 0_57_7 6^^ 








1 










4 










5 










6 




78 


1500 


3 


4 


■■brcd_3 900_57_7 8^^ 








5 










6 




79 


1500 


3 


4 


■■brcd_3 90 0_57_7 9^^ 








5 










6 




80 


1500 


3 


4 


■■brcd_3 8_57_80^^ 








5 










6 




81 


1500 


3 


4 


■■brcd_3 8_57_81^^ 








5 










6 




100 


1000 


2 


4 


■■AP_57_7 5^^ 








5 










6 




116 


1000 


2 


0 


■■brcd_390 0_116^^ 








1 










12 










13 










14 





See also 

portRouteInf o 
urouteShow 
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trunkReset 

Turns off trunking. 

Synopsis 

trunkreset 

Availability 

admin 

Description 

Use this command to turn off trunking. 

Operands 

none 

Examples 

To turn off trunking: 



switch : adinin> trunkreset 
Trunk Feature Disabled 



See also 

dlsSet 

dlsShow 

iodReset 

iodSet 

iodShow 

trunkSet 

trunkShow 
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trunkSet 

Turns on trunking. 

Synopsis 

trunkset 

Availability 

admin 

Description 

Use this command to allow dynamic exchange-level trunking across all available E Port links to reach the 
next hop. If trunking is enabled, all E Ports to a given next hop domain are automatically added to the 
trunk route. Each trunk route can have a maximum of 16 E_Ports. 

With trunking enabled, for each frame received at the port, the exit port to use to route the frame is 
selected based on: 

( (dest_id + src_id + ox_id) % num_routes_in_trunk) 

Trunking is turned off by default. To turn on trunking, enter the trunkset command after installing the 
XPath Exchange-Based Trunking license. Trunking overrides the dynamic load sharing setting (dlsSet). 

Operands 

none 

Examples 

To turn on trunking: 

switch : ac3inin> trunkset 
Trunk Feature enabled 

See also 

dlsReset 

dIsSet 

dlsShow 

iodReset 

iodSet 

iodShow 

licenseShow 

nbrStateShow 

topologyShow 

trunkReset 

trunkShow 

urouteShow 
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trunkShow 

Displays the trunk setting. 

Synopsis 

trunkshow 

Availability 

all users 

Description 

Use this command to see whether trunking is on (set) or off. 

Operands 

none 

Examples 

To display the trunk setting: 

switch : adinin> trunkshow 
Trunking is set 

See also 

dlsReset 

dlsSet 

dlsShow 

iodReset 

iodSet 

iodShow 

trunkReset 

trunkSet 
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tsClockServer 



Displays or sets the network time synchronization (NTP) server address. 

Synopsis 

tsclockserver [ipaddr] 

Availability 

admin 

Description 

This command displays or sets the NTP server address. It synchronizes the local time of the MP Router to 
an external NTP server. If no operand is specified, the current value is displayed. 

Operands 

This command has the follov/ing optional operand: 

ipaddr Specifies the IP address of the NTP server. This option enables 

the MP Router to synchronize with the specified external NTP 
server. The NTP server should be accessible from the MP Router. 

The default ipaddr value is LOCL. When a clock server IP 
address other than LOCL is specified, the date command will 
be restricted to display mode only. 

Examples 

To set the NTP server to the specified IP address: 

switch : ac3inin> tsclockserver 192.168.126.60 
tsclockserver is set 

To disable the NTP service: 

switch : admin> tsclockserver LOCL 
tsclockserver is set 

See also 

date 
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upTime 

Displays how long the system has been running. 

Synopsis 

uptime 

Availability 

admin 

Description 

Use this command to display the current time, the length of time the system has been up, the number of 
users, and the load average of the system over the last 1 , 5, and 1 5 minutes. 

Operands 

none 

Examples 

none 

See also 

none 
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urouteConfig 

Configures a static route. 

Synopsis 

urouteconf ig in-port domain out-port 

Availability 

admin 

Description 

Fibre Channel Shortest Path First (FSPF) allows load sharing of traffic across multiple equal-cost, equivalent 
paths. The assignment of routes to individual equivalent paths is done automatically. This assignment is not 
deterministic; it might be different after a reboot or a fabric topology change. This command allov/s the 
configuration of static routes. A static route is a route that is assigned to a specific path that does not 
change v/hen a topology change occurs unless the path used by the route becomes unavailable. 

After this command is entered, if output-port is a usable port, all frames coming in from port 
in-port addressed to domain are forwarded through port out-port. 

If out-port is not usable, the routing assignment is not affected by this command. When out-port 
becomes usable, however, the static route assignment for in-port is enforced. 

out-port is usable if it is on a minimum-cost path to the destination domain. 

in-port can be either an F_Port or an E_Port. 

Notes 

When using static routes, load sharing might be affected. The MP Router attempts to achieve the best load 
sharing, but if too many routes are statically configured to use the same output port, equal load-sharing 
might not be possible. 

To prevent routing loops, static route configuration through a non-minimum-cost path is not allowed. If a 
user attempts to configure such a route, the user is queried as to whether or not the entry should be saved 
in the database. 

Operands 

The following operands are required: 

in-port The input port to be configured with the static route. 

domain The destination domain. 

out-port The output port to which traffic is forwarded. 

Examples 

To configure a static route: 

switch : admin> urouteconf ig 3 71 1 
Committing configuration ... done 
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See also 

conf igShow 
portRouteInf o 
urouteRemove 
urouteShow 



XPath OS 7.4.x command reference guide 259 



urouteRemove 



Removes a static route. 

Synopsis 

urouteremove in-port domain 

Availability 

admin 

Description 

Use this command to remove a previously configured static route. 

After tfiis command is entered, the route to domain for in-port might or might not change. It W\\ 
change if the previous static route was not along a minimum-cost path. 

After this command is entered, the load sharing to domain is revaluated. 
Operands 

This command has the following required operands: 

in-port The port to be statically routed. 

domain The destination domain. 

Examples 

To remove a static route: 

switch : admin> urouteremove 3 71 
Committing configuration ... done 

See also 

conf igShow 
portRouteInf o 
urouteConf ig 
urouteShow 
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urouteShow 

Displays unicast routing information. 

Synopsis 

urouteshow [in-port [domain]] 

Availability 

all users 

Description 

Use this command to display the unicast routing information for a port as it is known by the Fibre Channel 
Shortest Path First (FSPF) path selection/ routing task. The routing information describes how a frame that is 
received from a port on the local MP Router is routed to reach a destination switch. 

The command displays the routing information for all the active ports on the local MP Router to all the 
domains in the fabric. 

The following fields are displayed: 

Local Domain ID The domain number of the local MP Router. 

In-Port The port from which a frame comes. 

Domain The destination domain of the incoming frame. 

Out-Port The port to which an incoming frame is forwarded to reach the 

destination domain. 

Metric The cost of reaching the destination domain. 

Hops The maximum number of hops required to reach the destination 

domain. 

Flags Whether this route is dynamic (D) or static (S). Adynamic 

route is discovered automatically by the FSPF path-selection 
protocol. A static route is assigned using the urouteConf ig 
command. 

Next (Dom, Port) Domain and port number of the next hop. These are the domain 

number and the port number of the switch to which Out-Port 
is connected. 

The information provided by this command should match what is provided by portRouteinf o and 
topologyShow. 

Operands 

This command has the following optional operands: 

in-port Displays the routing information for the port from which a frame 

comes to all domains in the fabric. 

in-port domain Displays the routing information for the port from which a frame 

comes to the destination domain. 
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Examples 

To display unicast routing information: 



switch : admin> urouteshow 
Local Domain ID: 50 



Domain 


Out-Port 


Metric 


Hops 


Flags 


Next (Dom, Port) 


54 


11 


1500 


3 


D 


71,1 


58 


11 


1000 


2 


D 


71, 1 


70 


11 


3000 


6 


D 


71,1 


71 


11 


500 


1 


D 


71,1 


73 


11 


2000 


4 


D 


71,1 


76 


11 


2500 


5 


D 


71,1 


54 


11 


1500 


3 


D 


71,1 


58 


11 


1000 


2 


D 


71,1 


70 


11 


3000 


6 


D 


71,1 


71 


11 


500 


1 


D 


71,1 


73 


11 


2000 


4 


D 


71,1 


76 


11 


2500 


5 


D 


71,1 



See also 

portRouteInf o 
topologyShow 
urouteConf ig 
urouteRemove 
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userAdd 

Adds a new user to the MP Router. 

Synopsis 

useradd -u userName -g userGroup 

Availability 

admin 

Description 

Use this command to add a new user to the MP Router. There are two permanent user accounts (or groups) 
to which you can assign a user: admin and user. Each account has a default password of password. 

Operands 

The following operands are required: 

-u userName Specifies the new user name. 

-g userGroup Specifies the group for the new user. 

Examples 

To add a new user (John) with an admin account, after logging in as admin: 

switch : aditiin> useradd -u John -g admin 
To add a new user (Mike) with a user account, after logging in as admin: 

switch : adinin> useradd -u mike -g user 

See also 

passwd 

userDel 

userShow 
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userDel 

Removes a user from the MP Router. 

Synopsis 

userdel userName 

Availability 

admin 

Description 

Use this command to remove a user from the MP Router; hov/ever, the admin and user (permanent) 
accounts cannot be deleted. Furthermore, users logged in as admin can delete all users except themselves. 

Operands 

The following operand is required: 

userName Name of user to be removed. 

Examples 

To remove a user (John) from the MP Router after logging in as admin: 

switch : admin> userdel John 

See also 

passwd 
user Add 
userShow 
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users 

Lists current users. 

Synopsis 

users 
Description 

Use this command to list (sorted, separated by spaces, and on one line) the login names of the users 
currently on the system. 

Operands 

none 

Examples 

none 

See also 

none 
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userShow 

Displays a list of available users on the MP Router. 

Synopsis 

usershow 

Availability 

all users 

Description 

Use this command to display a list of available users on the MP Router. 

Operands 

none 

Examples 

To display all users available on the MP Router, after logging in as admin: 

switch : admin> usershow 

userName with admin role 

admin 
adminl23 

userName with user role 

user 
userl23 

See also 

passwd 
user Add 
userDel 
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version 

Displays the version numbers for MP Router software components. 

Synopsis 

version 

Availability 

all users 

Description 

Use this command to display the version numbers of the MP Router softv/are components. 

Operands 

none 

Examples 

To display the version numbers of all softv/are components in a switch: 



switch : adinin> version 






Installed Packages 






Package Name : 


xpath_os_v7 . 4 . 0_ 


_prealphal_bldl7 


Install Date: 


Apr 14, 2005 18 


:48 



See also 

altBoot 

f irmwareCommit 
f irmwareDownload 
f irmwareShow 
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wdogevt 

Displays the watchdog events. 

Synopsis 

wdogevt 

Availability 

admin 

Description 

Use this command to display watchdog events logged in system NVRAM. 

Operands 

none 

Examples 

To display the watchdog events: 

switch : admin> wdogevt 

wdogevt: last shutdown due to watchdog timeout 
wdogevt: last known timeout recorded at UTC Tue 



Dec 


16 15:39 


40 


2003 


debug trace: 






sp: 


8ad75c70 


Ir 


11833e98 


sp: 


8ad75ca0 


Ir 


00034d20 


sp: 


8ad75cb0 


Ir 


OOOffOec 


sp: 


8ad75ce0 


Ir 


00005758 


sp: 


8ad75dl0 


Ir 


00005428 


sp: 


8ad75d20 


Ir 


00005a08 


sp: 


8ad75d40 


Ir 


000c01b8 


sp: 


8ad75d80 


Ir 


000b9d08 


sp: 


8ad75e20 


Ir 


000b9630 


sp: 


8ad75ee0 


Ir 


00091354 


sp: 


8ad75f40 


Ir 


000e70c0 


sp: 


f f f fe730 


Ir 


00003f44 


sp: 


00000000 


Ir 


00000000 



NOTE: There are no debug traces for administrator actions or power failures. The debug trace indicates 
the problem area within the operating system and is likely different from the example shown here. 



All system events are available in the system log. 
See also 

none 
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zoneAdd 

Adds a member to a zone. 

Synopsis 

zoneadd " zoneName", " zoneMemberList" 

Availability 

admin 

Description 

Use this command to add one or more members to the existing zone. For a description of members, see 
the zoneCreate help. 



p2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cf gEnable command. 

For the change to be preserved across MP Router reboots, save it to nonvolatile memory using the 
cfgSave command. 



Operands 

The following operands are required: 

"zoneName" The name of a zone, in quotation marks. 

"zoneMemberList" A semicolon-separated list of one or more world wide names, 

domain, port pairs, zone alias names, and IQNs in 
quotation marks. 



Examples 

To add some disk arrays to ZONE_A: 



switch;admin> zoneadd "ZONE_A", " 2 0 : 00 : 00 : eO : 8b : 01 : 8f : 85 ; 100,1; 
ALIASl " 



See also 

zoneCreate 
zoneDelete 
zoneRemove 
zoneShow 
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zoneCreate 



Creates a zone. 

Synopsis 

zonecreate " zoneName", " zoneMemberList" 

Availability 

admin 

Description 

Use this command to create a new zone. 



\^^}f NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
C— I effective, you must enable an appropriate zone configuration using the cfgEnable command. 

For the change to be preserved across MP Router reboots, save it to nonvolatile memory using the 
cfgSave command. 



Operands 

The following operands are required: 

"zoneName" A unique name for a zone, in quotation marks. A zone name begins 

with a letter followed by any number of letters, digits, and underscore 
characters. Names are case sensitive; for example, "Zone_l " and 
zone_l are different zones. Spaces are ignored. 

"zoneMemberList" A semicolon-separated list of one or more World Wide Names, 

domain, port pairs, zone alias names, and iSCSI qualified names 
(IQNs), in quotation marks. Requirements for the zoneMemberList 
are as follows: 

• World wide names— These names must be specified as eight 
hexadecimal numbers separated by colons, for example, 

1 0:00:00:60:69:00:00:8a. Zoning has no knowledge of the fields 
within a WWN; the 8 bytes are simply compared with the node 
and port names presented by a device in a login frame (FLOGI or 
PLOGI). When a zone member is specified by node name, then all 
ports on that device are in the zone; when a zone member is 
specified by port name, only that single device port is in the zone. 

• Domain, port pairs— Physical fabric port numbers can be specified 
as a pair of decimal numbers d, p where d is the MP Router number 
(domain ID) and p is the port number on that MP Router. For 
example, 6,10 specifies port 1 0 on MP Router 6. When an alias 
member is specified by physical fabric port number, all devices 
connected to that port are in the zone. No spaces are allowed. 
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Zone alias names— Zone alias names have the same format as zone 
names and are created with the aliCreate command. 



The alias must resolve to a list of one or more physical fabric port 
numbers or WWNs. A zone alias should be created before it is 
added to a zone. 

• IQNs— IQNs are specified in the following format: 

iqn . year-month . unigue_iSCSI_domain_ID, as follows: 
iqn. 1991-05 . com. microsoft : rst-win2k-pcl2 

Examples 

To create two zones, ZONE_A and ZONE_B: 



switch; 


: admin> 


zonecreate 


"ZONE_A" , 


"21; 


:00; 


:00: 


:20; 


:37 ; 


;65; 


: ec ; 


:43; 


arrayl " 


switch; 


: adinin> 


zonecreate 


"ZONE_B" , 


"21 ; 


:01; 


;00: 


:eO ; 


:8b; 


;22 ; 


:a2 ; 


:3 8; 


2 0,3" 



























See also 

zone Add 
zoneDelete 
zoneRemove 
zoneShow 
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zoneDelete 

Deletes a zone. 

Synopsis 

zonedelete " zoneName" 

Availability 

admin 

Description 

Use this command to delete the zone, zoneName. 



"2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
effective, you must enable an appropriate zone configuration using the cfgEnable command. 

For the change to be preserved across router reboots, save it to nonvolatile memory using the cfgSave 
command. 



Operands 

The follov/ing operand is required: 

"zoneName" The name of the zone, in quotation marks. 

Examples 

To delete ZONE_A: 

switch : admin> zonedelete "ZONE_A" 

See also 

zone Add 
zoneCreate 
zoneRemove 
zoneShow 
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zoneRemove 

Removes a member from a zone. 

Synopsis 

zoneremove " zoneName", " zoneMemberList" 

Availability 

admin 

Description 

Use tfiis command to remove one or more members from the existing zone. If all members are removed, 
the zone is deleted. 

For a description of members, see the zoneCreate help. 
The member list is found by an exact string match. 

r2^^ NOTE: This command changes the defined configuration (see cf gShow). For the change to become 
li— I effective, you must enable an appropriate zone configuration using the cf gEnable command. 

For the change to be preserved across router reboots, save it to nonvolatile memory using the cf gSave 
command. 



Operands 

The follov/ing operands are required: 

"zoneName" The name of the zone, in quotation marks. 

"zoneMemberList" A semicolon-separated list of one or more world wide names, 

domain,port pairs, zone alias names, and IQNs, in quotation 
marks. 

Examples 

To remove 20:00:00:e0:8b:01 :8f:85 and 100,3 from ZONE_A: 

switch :admin> zoneremove "ZONE_A", "20 : 00 : 00 : eO : 8b: 01 : 8f : 85 ; 100,3" 



See also 

zone Add 
zoneCreate 
zoneDelete 
zoneShow 
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zoneShow 

Displays zone information. 

Synopsis 

zoneshow [-i] [pattern] 

Availability 

all users 

Description 

Use this command without parameters to display all zone configuration information. 

If a parameter is specified, it is used as a pattern to match zone names; those that match in the defined 
configuration are displayed. 

Patterns can contain: 

• Question mark (?), which matches any single character 

• Asterisk (*), which matches any string of characters 

• Characters [0-9, a-z, A-Z,_], which match the character 
See cf gShow for a description of this display. 

Operands 

The following operands are optional: 

-i Displays IQNs instead of world wide names (WWNs). 

pattern Pattern can contain any of the valid characters mentioned. 

Examples 

To display configuration information for zones specified by the pattern Z*l : 



swi tch : admin> 


zoneshow "z*l" 






Zone : ZONEl 










21:00:00:20:37:65 


6f 


16 




21:00:00:20:37:65 


6a 


d9 




100, 1 








20,3 (unconfirmed) 








ALIAS 1 







See also 

aliShow 
cf gShow 
zone Add 
zoneCreate 
zoneDelete 
zoneRemove 
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zsdLogClear 

Synopsis 

zsdlogclear 

Availability 

admin 

Description 

Use this command to clear the internal debug messages of the zone server. 

Operands 

none 

Examples 

To clear the internal debug messages: 

switch ; adinin> zsdlogclear 

See also 

zsdLogShow 
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zsdLogShow 

Displays the zone server's internal debug messages. 

Synopsis 

zsdlogshow 

Availability 

admin 

Description 

Use this command to display the zone server's internal debug messages. 

Operands 

none 

Examples 

To display the zone server's internal debug messages: 

switch : admin> zsdlogshow 

Time |d |0XID| Log info 



16 


29 


09 


966 


01 


0000 1 


MMI 


license call 








16 


29 


12 


495 


f f 


f 101 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


12 


496 


f f 


0113 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


12 


497 


f f 


0114 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


12 


501 


f f 


0114 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


12 


507 


f f 


0117 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


12 


508 


f f 


0114 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


12 


515 


f f 


0118 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


22 


795 


f f 


0202 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


22 


795 


f f 


ff ff 1 


activate msg 


zone set name [cfg2] 


16 


29 


22 


867 


f f 


ff ff 1 


sending zone 


enable 


request 




16 


29 


25 


280 


ff 


f 101 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


25 


281 


f f 


0113 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


25 


282 


f f 


0114 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


25 


286 


f f 


0114 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


25 


290 


f f 


0117 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


25 


292 


f f 


0114 1 


msg 


received 


at 


the 


Zoneserver 


port 


16 


29 


25 


295 


f f 


0118 1 


msg 


received 


at 


the 


Zoneserver 


port 


18 


14 


15 


837 


f f 


0001 1 


domains list 


Received from fspf 


18 


14 


28 


285 


f f 


0001 1 


domains list 


Received from fspf 


18 


15 


08 


967 


f f 


f 101 1 


msg 


received 


at 


the 


Zoneserver 


port 


18 


15 


08 


968 


ff 


0113 1 


msg 


received 


at 


the 


Zoneserver 


port 



See also 

zsdLogClear 
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2 Default values for configuration parameters 



This chapter lists the default values for: 

• System configuration parameters. Table 2. 

• Management interface configuration parameters. Table 3. 

• Port configuration parameters. Table 4. 

Default values for system parameters 



Table 2 lists the default values for the system parameters. 
Table 2 Default values for system parameters 



I'M a4 


L/GTaUli VQIUG 


DDL.rea.1 c 


1 D 


c ha s s 1 s Adm i n 


-1 
1 


a.a.tar leicibize 




def aul tAcces s Zoning 


-1 
1 


d.e f med-Tirans Z onsMgrfit 


u 


d-i sat)leNod.eNanie Zoning" 


-1 
1 


d-omain 


inn 
1 U U 


doiua ml d.C on f i iritiF lag 


U 


d.y n am 1 c L o a d. S h. a iri n g 


U 


Ji U 1 (J V 


o n n n 
z U U U 


eventLogSize 


1 n n n 
1 U U U 


f ileTiransf eirPirotocol 


t f tp 


4— V "D y-^ y-^ 4— -1 

r cpKoo CJJir 


/ ■(- -F ■(- v-iV-i^ ^ ■(- 
/ L L UpOOO L 


f tpServerlpAddress 


n n n n 


f tpUserName 


E up 


ftpUser Pas sword. 


L up 




- A n 


hardZoningSupported 


0 


inOrderDelivery 


1 


MAX_HOP_COUNT 


7 


pollinglnterval 


0 


R_A_TOV 


10000 


snmpRoCommuni ty 


public 


snmpRwCoiranuni ty 


private 


staticRouteTable 


Empty 


switchTrunk 


1 


sysContact 


Field Support 
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Table 2 Default values for system parameters (continued) 



Parameter 


1% f la 1 

Default value 


sysDescription 


Multi-protocol Router 


sysLocation 


End User Premise 


sysName 


MP Router 


sysObj ectID 


1.3.6.1.4.1.1588.2.1.1.38 


sysServices 


72 


sysUrl 


MY_SYS_URL 


temperatureShutdownThreshold 


65 


temperatureWarningThreshold 


45 


trapReceiverTable 


Empty 


WAN_TOV 


0 


wwn 


0x00 0x00 0x00 0x05 Ox4e 0x01 0x02 
0x00 



Default values for management interface parameters 



Table 3 lists tfie default values for management interface parameters. 
Table 3 Default values for management interface parameters 



Parameter 


Default value 


gateway (mgmt port 1) 


sync with the setup nvram 


gateway (mgmt port 2) 


0 


if Mode (mgmt port 1) 


auto 


if Mode (mgmt port 2) 


auto 


ipAddr (mgmt port 1) 


sync with the setup nvram 


ipAddr (mgmt port 2) 


0 


netmask (mgmt port 1) 


sync with the setup nvram 


netmask (mgmt port 2) 


0 


t values for port parameters 

Table 4 lists tfie default values for tfie port parameters. 
Table 4 Default values for port parameters 


Parameter 


Default value 


acceptMode 


2 


bbCredit 


16 


dataFieldSize 


2112 


def aultGateway 


0 


edtov 


2000 


eMode 


1 
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Table 4 Default values for port parameters (continued) 



Parameter 


Detault value 


f cipEnable 


2 


ipAddr 


0 


linkAdmin 


1 


linkCost 


Oxf f f f 


linkTrapEnable 


1 


listenPort 


3225 


netmask 


0 


portAdmin 


1 


portSpeed 


0 


portTopology 


3 


portType 


1 


promiscuousMode 


1 


ratov 


10000 


remoteEntityld 


0 


r emo t e IpAddr 


0 


remoteTcpPort 


3225 


remoteWwn 


0 
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Glossary 



This glossary defines terms used in this guide or related to this product and is not a comprehensive 
glossary of computer terms. 



address identifier 
AL_PA 

ALJIME 

alias 



alias address 
identifier 

alias AL_PA 

alias server 

ANSI 

ARB 

arbitrated loop 

arbitration 
area number 



ARP 

ARR 

ASD 

ASIC 
ATM 

authentication 

AW_TOV 

bandwidth 

BB Credit 



A 24-bit or 8-bit value used to identify the source or destination of a frame. 

Arbitrated Loop Physical Address. A unique 8-bit value assigned during loop initialization to a 
port in an arbitrated loop. 

Arbitrated loop timeout value. Twice the amount of time it would take for a transmission word 
to propagate around a worst-case loop. The default value is 15 milliseconds (ms). 

A logical grouping of elements in a fabric. An alias is a collection of port numbers and 
connected devices, used to simplify the entry of port numbers and WWNs when creating 
zones. 

An address identifier recognized by a port in addition to its standard identifier. An alias 
address identifier can be shared by multiple ports. See also olios. 

An AL PA value recognized by an L Port in addition to the AL_PA assigned to the port. See 
also AL_PA. 

A fabric software facility that supports multicast group management. 
American National Standards Institute. 

Arbitrative primitive signal. Applies only to an arbitrated-loop topology. Transmitted as the fill 
word by an L Port to indicate that the port is arbitrating access to the loop. 

A shared 100-Mb/s Fibre Channel transport structured as a loop. Can support up to 126 
devices and one fabric attachment. See also topology. 

A method of gaining orderly access to a shared-loop topology. 

Ports on a switch are assigned a logical area number. Port area numbers can be viewed by 
entering the switchShow command. They are used to define the operative port for many 
Fabric OS commands; for example, area numbers can be used to define the ports within an 
alias or zone. 

Address Resolution Protocol. A TCP/IP function for associating an IP address with a link-level 
address. 

Asynchronous response router. Refers to Management Server GS_Subtype Code E4, which is 
displayed in the portLogDump command output. 

Alias server daemon. Used for managing multicast groups by supporting the create, add, 
remove, and destroy functions. 

Application-specific integrated circuit. 

Asynchronous Transfer Mode. A transport used for transmitting data over LANs or WANs that 
transmit fixed-length units of data. Provides any-to-any connectivity and allows nodes to 
transmit simultaneously. 

The process of verifying that an entity in a fabric (such as a switch) is what it claims to be. See 
a/so digital certificate, switch-to-switch authentication. 

Arbitration wait timeout value. The minimum time an arbitrating L Port waits for a response 
before beginning loop initialization. 

The total transmission capacity of a cable, link, or system. Usually measured in bps (bits per 
second). Bandwidth can also refer to the range of transmission frequencies available to a link 
or system. See also throughput. 

buffer-to-buffer credit. The number of frames that can be transmitted to a directly connected 
recipient or within an arbitrated loop. Determined by the number of receive buffers available. 
See also buffer-to-buffer flow control, EE_Credit. 
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beacon 

beginning running 
disparity 

BER 

BISR 
BIST 

bit synchronization 

blind-mate 
connector 

block 

boot code 

boot flash 

bport 

broadcast 

buffer-to-buffer flow 
control 

bypass circuitry 

CA 

CAM 
CAN 

cascade 
CFG 
chassis 
CIM 

circuit 

Class 1 service 

Class 2 service 
Class 3 service 

Class 4 service 
Class 6 service 



A tool in which all of the port LEDs on an MP Router are set to flash from one side of the switch 
to the other, to enable identification of an individual MP Router in a large fabric. An MP Router 
can be set to beacon by the beacon command. 

The disparity at the transmitter or receiver when the special character associated with an 
ordered set is encoded or decoded. See also disparity. 

Bit error rate. The rate at which bits are expected to be received in error. Expressed as the ratio 
of error bits to total bits transmitted. See also error. 

Built-in self-repair. 

Built-in self-test. 

The condition in which a receiver is delivering retimed serial data at the required bit error rate. 

A two-way connector used in some HP StorageWorks switches to provide a connection 
between the motherboard and the power supply. 

As it applies to Fibre Channel technology, upper-level application data that is transferred in a 
single sequence. 

Software that initializes the system environment during the early phase of the boot process. For 
example, boot code might determine the amount of available memory and how to access it. 

Flash (temporary) memory that stores the boot code. 

Back-end port of the ASIC. 

The transmission of data from a single source to all devices in the fabric, regardless of zoning. 
See also multicast, unicast. 

Management of the frame transmission rate in either a point-to-point topology or in an 
arbitrated loop. See also BB_Credit. 

Circuits that automatically remove a device from the data path when valid signals are 
dropped. 

Certificate authority. A trusted organization that issues digital certificates. See also digital 
certificate. 

Content-addressable memory. 

Campus area network. A network comprising a limited area but not just one building. See 
also LAN, MAN, WAN. 

Two or more interconnected Fibre Channel switches. See also fabric, ISL. 
Configuration. 

The metal frame in which the switch and switch components are mounted. 

Common Information Model. A management structure enabling disparate resources to be 
managed by a common application. 

An established communication path between two ports. Consists of two virtual circuits capable 
of transmitting in opposite directions. 

The class of frame-switching service for a dedicated connection between two communicating 
ports (also called connection-oriented service). Includes acknowledgement of frame delivery or 
nondelivery. 

A connectionless class of frame-switching service that includes acknowledgement of frame 
delivery or nondelivery. 

A connectionless class of frame-switching service that does not include acknowledgement of 
frame delivery or nondelivery. Can be used to provide a multicast connection between the 
frame originator and recipients, with acknowledgement of frame delivery or nondelivery. 

A connection-oriented service that allows fractional parts of the bandwidth to be used in a 
virtual circuit. 

A connection-oriented multicast service geared toward video broadcasts between a central 
server and clients. 
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Class F service 

class of service 
CLI 

client 
CLS 

CM 

CMA 

CMBISR 

CMT 

comma 

community (SNMP) 
compact flash 

configuration 



congestion 
connection initiator 
connection recipient 
controller 
core PID 

COS 

CP 

CPLD 

CRC 

credit 

cut-through 

DJD 

DAS 



The class of frame-switching service for a direct connection between two switches, allowing 
communication of control traffic between the E_Ports. Includes acknowledgement of data 
delivery or nondelivery. 

A specified set of delivery characteristics and attributes for frame delivery. 

Command line interface. An interface that depends entirely on the use of commands, such as 
through Telnet or SNMP, and does not involve a GUI. 

An entity that, using its common transport (CT), makes requests of a server. 

Close primitive signal. Used only in an arbitrated loop. Sent by an L_Port that is currently 
communicating in the loop to close communication with another L_Port. 

Central memory. 

Central memory architecture. An architecture centralizing memory usage in switches. 
Central memory built-in self-repair. 
Central memory test. 

A unique pattern (either 1 1 00000 or 001 1111) used in 8b/l Ob encoding to specify 
character alignment within a data stream. See also K28.5. 

A relationship between a group of SNMP managers and an SNMP agent, in which 
authentication, access control, and proxy characteristics are defined. See also SNMP. 

Flash (temporary) memory that is used in a manner similar to hard disk storage. It is connected 
to a bridging component that connects to the PCI bus of the processor. Not visible within the 
processor's memory space. 

(1 ) A set of parameters that can be modified to fine-tune the operation of a switch. Use the 
conf igShow command to view the current configuration of your switch. 

(2) In zoning, a zoning element that contains a set of zones. The configuration is the 
highest-level zoning element and is used to enable or disable a set of zones on the fabric. See 
also zone configuration. 

The realization of the potential of oversubscription. A congested link is one on which multiple 
devices are contending for bandwidth. 

A port that has originated a Class 1 dedicated connection and has received a response from 
the recipient. 

A port that has received a Class 1 dedicated connection request and has transmitted a 
response to the originator. 

A computer module that interprets signals between a host and a peripheral device. The 
controller typically is part of the peripheral device. 

Core switch port identifier. The core PID must be set for OS 3.1 and earlier switches included 
in a fabric of 4.1 switches. This parameter is located in the configure command of 
firmware versions 3.1 and earlier. All 4.1 switches and later use the core PID format by 
default; this parameter is not present in the configure command for these switches. 

Class of service. 

Control processor. 

Complex PLD. Alternately known as Enhanced PLD (EPLD), Super PAL, and Mega PAL. 

Cyclic redundancy check. A transmission error check that is included in every data frame. 

As it applies to Fibre Channel technology, the number of receive buffers available to transmit 
frames between ports. See also BB Credit, EE Credit. 

A switching technique that allows the route for a frame to be selected as soon as the 
destination address is received. See also route. 

Destination identifier. A 3-byte field in the frame header, used to indicate the address identifier 
of the N_Port to which the frame is headed. 

Direct attached storage. 
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data word 
datagram 
DCE 

dedicated simplex 

defined zone 
configuration 

DHCP 

DHCPD 

digital certificate 

disparity 

DLS 

domain controller 
domain ID 
DTE 

DWDM 
E_D_TOV 

E_Port 
ECCN 

EE_Credit 

EIA rack 

ELP 

ELS 

EM 

embedded port 
EMI 

emulex 

enabled zone 
configuration 



A type of transmission word that occurs within frames. The frame header, data field, and CRC 
all consist of data words. See also frame, ordered set, transmission word. 

A Class 3 Fibre Channel service that allows data to be sent quickly to devices attached to the 
fabric, without receipt confirmation. 

Data communications equipment. Usually refers to a modem. 

A connection method that permits a single N Port to simultaneously initiate a session with one 
N Port as an initiator and have a separate Class 1 connection to another N Port as a 
recipient. 

The set of all zone objects defined in the fabric. Can include multiple zone configurations. See 
also enabled zone configuration, zone configuration. 

Dynamic Host Configuration Protocol. 

Dynamic Host Configuration Protocol daemon. 

An electronic document issued by a CA (certificate authority) to an entity, containing the 
public key and identity of the entity. Entities in a secure fabric are authenticated based on 
these certificates. See also authentication, CA, public key. 

The proportion of ones and zeroes in an encoded character. Neutral disparity means an equal 
number of each, positive disparity means a majority of ones, and negative disparity means a 
majority of zeroes. 

Dynamic load-sharing. Dynamic distribution of traffic over available paths. Allows for 
recomputing of routes when an Fx Port or an E Port changes status. 

A domain controller (or embedded port) communicates with and gets updates from other 
switches' embedded ports. The well-known address is f f f cdd, where dd = domain number. 

A unique identifier for all switches in a fabric, used in routing frames. Usually automatically 
assigned by the principal switch but can be assigned manually. 

Data terminal equipment. Usually refers to a terminal. 

Dense wave division multiplexing. Allows more wavelengths to use the same fiber. See also 
WDM. 

Error-detect timeout value. The minimum amount of time a target waits for a sequence to 
complete before initiating recovery. Can also be defined as the maximum time allowed for a 
round-trip transmission before an error is declared. See also R_A_TOV, RR_TOV. 

Expansion port. A type of switch port that can be connected to an E_Port on another switch to 
create an ISL. See also ISL. 

Export classification control number. A government classification of encryption. For example, 
SSH is in the high-encryption category (number 5x02) and therefore has certain restrictions 
regarding its transfer. 

End-to-end credit. The number of receive buffers allocated by a recipient port to an originating 
port. Used by Class 1 and 2 services to manage frame exchange across the fabric, between 
source and destination. See also BB_Credit, end-to-end flow control. 

A storage rack that meets the standards set by the Electronics Industry Alliance (EIA). 

Exchange link parameters. 

Extended link service. ELSs are sent to the destination N_Port to perform the requested function 
or service. ELS is a Fibre Channel standard that is sometimes referred to as Fibre Channel 
Physical (FC_PH) ELS. 

Environmental monitor. Monitors FRUs and reports failures. 

An embedded port (or domain controller) communicates and get updates from other switches' 
embedded ports. The well-known address is f f f cdd, where dd = domain number. 

Electromagnetic interference. 

A brand of host bus adapter (HBA). 

The currently enabled configuration of zones. Only one configuration can be enabled at a 
time. See also defined zone configuration, zone configuration. 
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end-to-end flow 
control 

entry fabric 

EOF 

error 

Ethernet 

EVMd 

exchange 

F_BSY 

F_Port 

F_RJT 

fabric 

Fabric Mode 

fabric name 
fabric port count 
fabric services 
fabric topology 
failover 

FAN 

fan-in 

fan-out 

FC-0 

FC-1 

FC-2 

FC-3 

FC-4 

FC-AL-3 

FC-AV 

FCC 

FC-a 

FC-FG 

FC-FLA 

FC-FS 

FC-GS 



Governs flow of Class 1 and 2 frames between N Ports. See also EE Credit. 

The basic software license that allows one E_Port per switch. 

End of frame. A group of ordered sets used to mark the end of a frame. 

As it applies to the Fibre Channel industry, a missing or corrupted frame, timeout, loss of 
synchronization, or loss of signal (link errors). See also loop failure. 

Popular protocol for LANs. 

Event management database. Delivers FDMI-related events. 

The highest-level Fibre Channel mechanism used for communication between N_Ports. 
Composed of one or more related sequences, it can work in either one or both directions. 

Fabric port busy frame. A frame issued by the fabric to indicate that a frame cannot be 
delivered because the fabric or destination N Port is busy. 

Fabric port. A port that is able to transmit under fabric protocol and interface over links. Can 
be used to connect an N_Port to a switch. See also FL_Port, Fx_Port. 

Fabric port reject frame. A frame issued by the fabric to indicate that delivery of a frame is 
being denied, perhaps because a class is not supported, there is an invalid header, or no 
N_Port is available. 

A Fibre Channel network containing two or more switches in addition to hosts and devices. 
Also referred to as a switched fabric. See also cascade, SAN, topology. 

One of two possible modes for an L Port, in which the L_Port is connected to another port that 
is not loop capable, using fabric protocol. 

The unique identifier assigned to a fabric and communicated during login and port discovery. 

The number of ports available for connection by nodes in a fabric. 

Codes that describe the communication to and from any well-known address. 

The arrangement of switches that form a fabric. 

Describes the process of one CP passing active status to another CP. A failover is 
nondisruptive. 

Fabric address notification. Retains the AL_PA and fabric address when a loop reinitializes, if 
the switch supports FAN. 

The ratio of hosts to storage devices; the view of the SAN from the storage port's perspective. 

The ratio of storage devices to hosts; the view of the SAN from the host port's perspective. 

Lowest layer of Fibre Channel transport. Represents physical media. 

Layer of Fibre Channel transport that contains the 8b/l Ob encoding scheme. 

Layer of Fibre Channel transport that handles framing and protocol, frame format, 
sequence/exchange management, and ordered set usage. 

Layer of Fibre Channel transport that contains common services used by multiple N Ports in a 
node. 

Layer of Fibre Channel transport that handles standards and profiles for mapping upper-level 
protocols, such as SCSI and IP, onto the Fibre Channel Protocol. 

The Fibre Channel Arbitrated Loop standard defined by ANSI. Defined on top of the FC-PH 
standards. 

Fibre Channel audio visual. 
Federal Communications Commission. 
Fibre Channel common transport. 
Fibre Channel generic requirements. 

The Fibre Channel fabric loop-attach standard defined by ANSI. 
Fibre Channel framing and signaling. 
Fibre Channel generic services. 
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FC-GS-2 
FC-GS-3 
FCJP 
FC-PH 

FC-PH-2 
FC-PH-3 
FC-PI 
FC-PLDA 

FC_SB 
FC_VI 
FCA 
FCIA 

FCLC 
FCP 

FCS 

FC-SW-2 

FDDI 
FDMI 

FFFFF5 
FFFFF6 
FFFFF7 
FFFFF8 
FFFFF9 
FFFFFA 
FFFFFB 
FFFFFC 
FFFFFD 
FFFFFE 
FFFFFF 
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Fibre Channel 
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Fibre Channel generic services, second generation. 
Fibre Channel Generic Services, third generation. 
Fibre Channel-over-IP. 

The Fibre Channel Physical and Signaling Interface standard for FC-0, FC-1, and FC-2 layers 
of the Fibre Channel Protocol. Indicates signaling used for cable plants, media types, and 
transmission speeds. 

Fibre Channel Physical Interface, second generation. 

Fibre Channel Physical Interface, third generation. 

Fibre Channel Physical Interface standard, defined by ANSI. 

The Fibre Channel Private Loop Direct Attach standard defined by ANSI. Applies to the 
operation of peripheral devices on a private loop. 

Fibre Channel single bytes. 

Fibre Channel virtual interface. 

Fibre Channel adapter. 

Fibre Channel Industry Association. An international organization of Fibre Channel industry 
professionals. Provides oversight of ANSI and industry-developed standards, among other 
tasks. 

Fibre Channel Loop Community. 

Fibre Channel Protocol. Mapping of protocols onto the Fibre Channel standard protocols. For 
example, SCSI FCP maps SCSI-3 onto Fibre Channel. 

Fibre Channel Standard. 

The second-generation Fibre Channel Switch Fabric standard defined by ANSI. Specifies tools 
and algorithms for the interconnection and initialization of Fibre Channel sv/itches to create a 
multiswitch Fibre Channel fabric. 

Fiber Distributed Data Interface. An ANSI architecture for a metropolitan area network (MAN); 
a network based on the use of fiber optic cable to transmit data at 1 00 Mb/s. 

Fabric-Device Management Interface. FDMI is a database service provided by the fabric for 
Nx Ports. The primary use is by HBA devices that register information about themselves and 
their ports. 

Well-known Fibre Channel address for a Class 6 multicast server. 
Well-known Fibre Channel address for a clock synchronization server. 
Well-known Fibre Channel address for a security key distribution server. 
Well-known Fibre Channel address for an alias server. 
Well-known Fibre Channel address for a QoS facilitator. 
Well-known Fibre Channel address for a management server. 
Well-known Fibre Channel address for a time server. 
Well-known Fibre Channel address for a directory server. 
Well-known Fibre Channel address for a fabric controller. 
Well-known Fibre Channel address for a fabric F Port. 
Well-known Fibre Channel address for a broadcast alias ID. 

Fibre Channel is a protocol used to transmit data between servers, switches, and storage 
devices. It is a high-speed, serial, bidirectional, topology-independent, multiprotocol, and 
highly scalable interconnection between computers, peripherals, and networks. 

A protocol service that supports communication between Fibre Channel service providers. See 
also FSP. 

First in, first out. Refers to a data buffer that follows the first in, first out rule. 

An IDLE or ARB ordered set that is transmitted during breaks between data frames to keep the 
Fibre Channel link active. 
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FRU 
FS 

FSP 

FSPF 
FSS 



FTP 

FTS 

full duplex 
full fabric 

full fabric citizenship 

Fx_Port 

G_Port 

gateway 

GBIC 

Gb/s 
GB/s 



The basic operating system provided with the hardware. 

Fabric loop port. A port that is able to transmit under fabric protocol and also has arbitrated 
loop capabilities. Can be used to connect an NL_Port to a switch. See also F_Port, Fx_Port. 

Programmable nonvolatile RAM (NVRAM) memory that maintains its contents without power. 

Fabric login. The process by which an N Port determines whether a fabric is present and, if 
so, exchanges service parameters with it. See also PLOGI. 

Fiber Optic Test Procedure. Standards developed and published by the Electronic Industries 
Association (EIA) under the EIA-RS-455 series of standards. 

Field-programmable device. Interchangeable with PLD. 

Field-programmable gate array. An FPD that allows high logic capacity. 

The partial use of a link to send data back and forth, with a maximum of 254 Class 4 
connections per N_Port. 

The Fibre Channel structure used to transmit data between ports. Consists of a start-of -frame 
delimiter, header, optional headers, data payload, cyclic redundancy check (CRC), and 
end-of-frame delimiter. There are two types of frames: link control frames (transmission 
acknowledgements and so forth) and data frames. 

A protocol that uses logical channels, as used in X.25. Provides very little error-checking 
ability. Discards frames that arrive with errors. Allows a certain level of bandwidth between 
two locations [known as a committed information rate (CIR)] to be guaranteed by the service 
provider. If CIR is exceeded for short periods (known as bursts), the network accommodates 
the extra data, if spare capacity is available. Frame relay is therefore known as bandwidth on 
demand. 

Field replaceable unit. A component that can be replaced onsite. 

Fibre Channel service. A service that is defined by Fibre Channel standards and exists at a 
well-known address. For example, the Simple Name Server is a Fibre Channel service. See 
also FSP. 

Fibre Channel Service Protocol. The common protocol for all fabric services, transparent to the 
fabric type or topology. See also FS. 

Fabric shortest path first. The routing protocol for Fibre Channel switches. 

Fabric OS state synchronization. The FSS service is related to high availability (HA). The 
primary function of FSS is to deliver state update messages from active components to their 
peer standby components. FSS determines if fabric elements are synchronized (and thus FSS 
compliant) . 

File Transfer Protocol. 

Fiber Transport Services. 

A mode of communication that allows the same port to simultaneously transmit and receive 
frames. See also half duplex. 

The software license that allows multiple E_Ports on a switch, making it possible to create 
multiple ISL links. 

A loop device that has an entry in the Simple Name Server. 

A fabric port that can operate as either an F Port or FL Port. See also F Port, FL Port. 

Generic port. A port that can operate as either an E Port or an F Port. A port is defined as a 
G_Port when it is not yet connected or has not yet assumed a specific function in the fabric. 

Hardware that connects incompatible networks by providing translation for both hardware 
and software. For example, an ATM gateway can be used to connect a Fibre Channel link to 
an ATM connection. 

Gigabit interface converter. A removable serial transceiver module that allows gigabaud 
physical-level transport for Fibre Channel and Gigabit Ethernet. 

Gigabits per second (1,062,500,000 bits/second). 

Gigabytes per second (1,062,500,000 bytes/second). 
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HA 
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Gigabit link module. A semitransparent transceiver that incorporates serializing/deserializing 
functions. 

Greenwich Mean Time. An international time zone. Also known as UTC. 

A graphic user interface, such as Advanced Web Tools and Fabric Manager. 

High availability. High-availability features are designed to provide maximum reliability and 
nondisruptive replacement of key hardware and software modules. 

A mode of communication that allows a port to either transmit or receive frames at any time 
except simultaneously (with the exception of link control frames, which can be transmitted at 
any time). See also full duplex. 

The AL_PA that an NL Port attempts to acquire during loop initialization. 

Host bus adapter. The interface card between a server or workstation bus and the Fibre 
Channel network. 

High-capacity PLD. Refers to both CPLDs and FPGAs. 

A Fibre Channel frame has a header and a payload. The header contains control and 
addressing information associated with the frame. 

High-Performance Parallel Interface. An 800 Mb/s interface normally used in supercomputer 
environments. 

The number of ISLs a frame must traverse to get from its source to its destination. 

A computer system that provides end users with services like computation and storage access. 

A hot-swappable component can be replaced under power. 

The brand name for the HP family of switches. 

High-speed serial data connection. A form factor that allows quick connections for copper 
interface. 

A second-generation HSSDC connector. 

Hypertext Transfer Protocol. The standard TCP/IP transfer protocol used on the World Wide 
Web. 

A Fibre Channel wiring concentrator that collapses a loop topology into a physical-star 
topology. Nodes are automatically added to the loop when active and removed when 
inactive. 

A number of N_Ports registered as a single Alias_ID so that the fabric can route a word to a 
port that is not busy. 

Hardware. 

Related to internal circuitry on the motherboard. 
Intracircuit test. 

Insistent domain ID. A parameter of the configure command in the Fabric OS. 

Continuous transmission of an ordered set over a Fibre Channel link when no data is being 
transmitted, to keep the link active and maintain bit, byte, and word synchronization. 

Internet Fibre Channel Protocol. Supports Fibre Channel Layer 4 FCP-over-TCP/IP. It is a 
gateway-to-gateway protocol in which TCP/IP switching and routing components enhance or 
replace Fibre Channel fabric. 

Transmission of management protocol over the Fibre Channel. 

A server or workstation on a Fibre Channel network that initiates communication with storage 
devices. See also target. 

A specification for copper cabling that allows up to 33-meter distances between cabinets. 
Allows any unused bandwidth in a Class 1 connection. 

A specification for copper cabling that allows up to a 1 3-meter (42-foot) distance within a 
single cabinet. 

I/O control. 
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In-order delivery. A parameter that, when set, guarantees that frames are either delivered in 
order or dropped. 

Internet Protocol. The addressing part of TCP. 
Intelligent Peripheral Interface. 
Internet Software Consortium. 

Internet Small Computer Systems Interface. A protocol that defines the processes for 
transferring block storage applications over TCP/IP networks by encapsulating SCSI 
commands into TCP and transporting them over the network by way of IP. 

Interswitch link. A Fibre Channel link from the E_Port of one switch to the E_Port of another. See 
also cascade, E_Port. 

The ratio of the number of free ports (non-ISL) to the number of ISLs on a switch. 

An E_Port that is online but not operational due to overlapping domain IDs or nonidentical 
parameters (such as E_D_TOVs). See also E Port. 

Internet service provider. 

Information unit. A set of information as defined by either an upper-level process protocol 
definition or upper-level protocol mapping. 

Just a bunch of disks. Indicates a number of disks connected in a single chassis to one or more 
controllers. See also RAID. 

A deviation in timing for a bit stream as it flows through a physical medium. 

A special 1 0-bit character used to indicate the beginning of a transmission word that performs 
Fibre Channel control and signaling functions. The first 7 bits of the character are the comma 
pattern. See also comma. 

A string of data (usually a numeric value) shared between two entities and used to control a 
cryptographic algorithm. Usually selected from a large pool of possible keys to make 
unauthorized identification of the key difficult. See also key pair. 

In public key cryptography, a pair of keys consisting of an entity's public and private key. The 
public key can be publicized, but the private key must be kept secret. See also public key 
cryptography. 

Loop port. A node port (NL Port) or fabric port (FL Port) that has arbitrated loop capabilities. 
An L_Port can be in either Fabric Mode or Loop Mode. 

Local area network. A network in which transmissions typically take place over fewer than 
5 kilometers (3.4 miles). 

The time required to transmit a frame. Together, latency and bandwidth define the speed and 
capacity of a link or system. 

Light-emitting diode. Used to indicate the status of elements on a switch. 

Loop-initialization fabric-assigned frame. Contains a bitmap of all fabric-assigned AL_PAs and 
is the first frame transmitted in the loop initialization process after a temporary loop master has 
been selected. 

Loop-initialization hard-assigned frame. A hard-assigned AL_PA that is indicated by a bit set 
and is the third frame transmitted in the loop initialization process after a temporary loop 
master has been selected. 

Loop-initialization loop-position frame. The final frame transmitted in a loop initialization 
process. A returned LIRP contains an accumulation of all of the AL PA position maps. This 
allows loop members to determine their relative loop position. This is an optional frame and is 
not transmitted unless the LIRP is also transmitted. 

A termination that handles physical and logical control of the Fibre Channel link for each 
mode. 

A protocol for link-related actions. 
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Loop initialization primitive. The signal used to begin initialization in a loop. Indicates either 
loop failure or node resetting. 

Loop-initialization previously assigned. The device marks a bit in the bitmap if it did not log in 
with the fabric in a previous loop initialization. 

Loop-initialization report position frame. The first frame transmitted in the loop initialization 
process after all L Ports have selected an AL PA. The LIRP gets transmitted around the loop so 
all L_Ports can report their relative physical position. This is an optional frame. 

Loop-initialization soft-assigned frame. The fourth frame transmitted in the loop initialization 
process after a temporary loop master has been selected. L_Ports that have not selected an 
AL_PA in a LIFA, LlPA, or LIHA frame select their AL_PA here. 

Loop-initialization select master frame. The first frame transmitted in the initialization process 
when L Ports select an AL PA. LISM is used to select a temporary loop master or the L Port that 
will subsequently start transmission of the LIFA, LlPA, LIHA, LISA, LIRP, or LILP frames. 

Loop master timeout value. The minimum time that the loop master waits for a loop 
initialization sequence to return. 

The unit that responds to login requests. 

A temporary bidirectional communication path established between L_Ports. 

Loss of signal within a loop for any period of time, or loss of synchronization for longer than 
the timeout value. 

A hexadecimal value representing one of the 1 27 possible AL PA values in an arbitrated loop. 

The logical procedure used by an L_Port to discover its environment. Can be used to assign 
AL PA addresses, detect loop failure, or reset a node. 

One of two possible modes for an L Port, in which the L_Port is in an arbitrated loop, using 
loop protocol. An L Port in Loop Mode can also be in Participating Mode or Nonparticipating 
Mode. 

A set of devices connected in a loop to a port that is a member of another loop. 

Loop port bypass. A primitive sequence transmitted by an L Port to bypass one or all L Ports to 
which it is directed. It is used only in arbitrated loops. 

Loop port enable. A primitive sequence transmitted by an L Port to enable one or all L Ports 
that have been bypassed with the LPB. It is used only in arbitrated loops. 

Loop Port State Machine. Logic that monitors and performs the tasks required for initialization 
and access to the loop. It is maintained by an L_Port to track behavior through different phases 
of loop operations. Alternatively, the logical entity that performs arbitrated-loop protocols and 
defines the behavior of L_Ports when they require access to an arbitrated loop. 

Link reset. A primitive sequence used during link initialization between two N_Ports in 
point-to-point topology or an N Port and an F Port in fabric topology. The expected response 
is an LRR. 

Link reset response. A primitive sequence during link initialization between two N Ports in 
point-to-point topology or an N Port and an F Port in fabric topology. It is sent in response to 
an LR and expects a response of Idle. 

Long wavelength. A type of fiber optic cabling that is based on 1 300-mm lasers and supports 
link speeds of 1 .0625 Gb/s. LWL can also refer to the type of GBIC or SFP. See also SWL. 

Memory allocation. Usually relates to buffer credits. 

Metropolitan area network. 

Megabytes per second. 

Megabits per second. 
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The collection of all devices, switches, edge and backbone fabrics, LSANs, and FC routers that 
make up a physically connected but logically partitioned storage network. LSANs span 
between edge fabrics using FC routers. In a data network, this would simply be called the 
network. However, an additional term is required to specify the difference between a 
single-fabric network (SAN), a multifabric network without cross-fabric connectivity 
(dual-redundant fabric SAN), and a multifabric network with connectivity (meta-SAN). 

A relative value assigned to a route to aid in calculating the shortest path (1 000 at 1 Gb/s, 
500 at 2 Gb/s). 

Media interface adapter. A device that converts optical connections to copper ones, and vice 
versa. 

Management Information Base. An SNMP structure to help with device management, 
providing configuration and device information. 

Multimode fiber. See also SWL. 

Mark primitive signal. Used only in arbitrated loop, MRK is transmitted by an L Port for 
synchronization and is vendor specific. 

Management Server. The Management Server allows a storage area network (SAN) 
management application to retrieve information and administer the fabric and interconnected 
elements, such as switches, servers, and storage devices. The MS is located at the Fibre 
Channel well-known address FFFFFAh. 

Management Server daemon. Monitors the MS. Includes the Fabric Configuration Service and 
the Unzoned Name Server. 

Mean time between failures. An expression of time, indicating the longevity of a device. 

The transmission of data from a single source to multiple specified N Ports (as opposed to all 
the ports on the network). See also broadcast, unicast. 

A fiber optic cabling specification that allows up to 500 meters between devices. 

Node port. A port on a node that can connect to a Fibre Channel port or to another N Port in 
a point-to-point connection. See also NL_Port, Nx_Port. 

Network attached storage. A disk array connected to a controller that gives access through a 
LAN. 

Network Data Management Protocol. Used for tape backup without using server resources. 

Node loop port. A node port that has arbitrated loop capabilities. Used to connect an 
equipment port to the fabric in a loop configuration through an FL Port. See also Nx_Port. 

A Fibre Channel device that contains an N Port or NL Port. 

The number of nodes attached to a fabric. 

The unique identifier for a node, communicated during login and port discovery. 

A mode in which an L Port in a loop is inactive and cannot arbitrate or send frames but can 
retransmit received transmissions. This mode is entered if there are more than 1 27 devices in a 
loop and an AL_PA cannot be acquired. See also L_Port, Participating Mode. 

Not operational. The NOS primitive sequence is transmitted to indicate that the FC_Port 
transmitting the NOS has detected a link failure or is offline, waiting for the offline sequence 
(OLS) to be received. 

Name Server. The service provided by a fabric switch that stores names, addresses, and 
attributes related to Fibre Channel objects. Can cache information for up to 15 minutes. Also 
known as Simple Name Server or as a directory service. See also Simple Name Server. 

Name Server Cache Manager. Updates the Name Server (NS) databases across switches as 
a background task. 

A node port that can operate as either an N Port or an NL Port. 

Open fiber control. A method used to enable and disable laser signaling for higher-intensity 
laser transceivers. 

Primitive sequence offline. 
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Online transaction processing. 

Offline notification. Refers to an ELS field that is displayed in portLogDump command output. 

Open primitive signal. Applies only to an arbitrated loop; sent by an L_Port that has won the 
arbitration process to open communication with one or more ports on the loop. 

A transmission word that uses 8b/10b mapping and begins with the K28.5 character. 
Ordered sets occur outside of frames and include the following items: 

• Frame delimiters— Mark frame boundaries and describe frame contents. 

• Primitive signals— Indicate events. 

• Primitive sequences— Indicate or initiate port states. 

Ordered sets are used to differentiate Fibre Channel control information from data frames and 
to manage frame transport. 

The Nx_Port that originated an exchange. 

Transmission of management protocol outside of the Fibre Channel network, usually over 
Ethernet. 

A situation in which more nodes could potentially contend for a resource than the resource 
could simultaneously support (typically an ISL). Oversubscription could be a desirable attribute 
in fabric topology, as long as it does not produce unacceptable levels of congestion. 

Originator ID. Refers to the exchange ID assigned by the originator port. 

A set of information transmitted across a network. See also frame. 

Programmable Array Logic. A relatively small FPD. 

The simultaneous transmission of data bits over multiple lines. 

A mode in which an L Port in a loop has a valid AL_PA and can arbitrate, send frames, and 
retransmit received transmissions. See also L_Port, Nonparticipating Mode. 

A low-cost copper Fibre Channel connection, allowing distances up to 13 meters between 
devices. 

The selection of a transmission path through the fabric. Switches use the FSPF protocol. See 
also FSPF. 

A Fibre Channel frame has a header and a payload. The payload contains the information 
being transported by the frame; it is determined by the higher-level service or FC_4 upper-level 
protocol. There are many different payload formats. 

Port bypass circuit. A circuit in hubs or a disk enclosure to open or close a loop to add or 
remove nodes. 

Printed circuit board assembly. 

Pulse-code modulation. A standard method of encoding analog audio signals in digital form. 

A feature that monitors port traffic and includes frame counters, SCSI read monitors, SCSI write 
monitors, and other types of monitors. 

Error messages of a high enough level (by default. Panic or Critical) are saved to flash memory 
on the switch instead of to RAM. These messages are saved over reboots and power cycles, 
constituting the persistent error log. 

An AL PA value that is assigned to a device that is not physically in the loop. Also known as 
phantom AL PA. 

A device that is not physically in an arbitrated loop but is logically included through the use of 
a phantom address. 

Port identifier. See also core PID. 

Public key infrastructure. An infrastructure that is based on public key cryptography and CA 
(certificate authority) and that uses digital certificates. See also CA, digital certificate, public 
key cryptography. 
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Public key infrastructure certification utility. A utility that makes it possible to collect certificate 
requests from switches and to load certificates to switches. See also digital certificate, PKI. 

Programmable logic array. A small FPD. 

Programmable logic device. Interchangeable with FPD. 

Private loop direct-attached. A technical report specifying a logical loop. 

Port login. The port-to-port login process by which initiators establish sessions with targets. See 
also FLOG!. 

A Fibre Channel topology that employs direct links between each pair of communicating 
entities. See also topology. 

An SFP or a GBIC receptacle on a switch to which an optic cable for another device is 
attached. 

In Fibre Channel technology, the port address is defined in hexadecimal. A port address can 
be defined by a domain and port number combination or by an area number. 

The metal casing extending out of the optical port on the switch, into which the SFP can be 
inserted. 

A hardware component that provides a platform for field-replaceable, hot-swappable ports. 
A record of all activity on a switch, kept in volatile memory. 

A view of what happens on a switch, from the switch's point of view. The portLogDump 
command is used to read the port log. 

A user-defined alphanumeric name for a port. 

Port swapping is the ability to redirect a failed port to another port. 

The unique identifier assigned to a Fibre Channel port. Communicated during login and port 
discovery. 

Power-on self test. A series of tests run by a switch after it is turned on. 
Point-to-Point Protocol. 

An ordered set that is transmitted repeatedly and continuously. Primitive sequences are 
transmitted to indicate specific conditions within or conditions encountered by the receiver 
logic of an FC_Port. See OLS, NOS. 

An ordered set that indicates actions or events and requires just one occurrence to trigger a 
response. IDLE and R RDY are used in all three topologies: ARB, OPN, and CLS. MRK is used 
in arbitrated loop. 

The first switch to boot in a fabric. Ensures unique domain IDs among roles. 

A device that supports arbitrated-loop protocol and can interpret 8-bit addresses but cannot 
log in to the fabric. 

The secret half of a key pair. See also key, key pair. 

An arbitrated loop that does not include a participating FL Port. 

A device that supports a loop and can understand 8-bit addresses but does not log in to the 
fabric. 

An NL_Port that communicates only with other private NL_Ports in the same loop and does not 
log in to the fabric. 

A defined method and set of standards for communication. Determines the type of error 
checking, the data-compression method, how sending devices indicate an end of message, 
and how receiving devices indicate receipt of a message. 

Port State Machine. 

Power supply unit. 

A device that supports arbitrated-loop protocol, can interpret 8-bit addresses, and can log in 
to the fabric. 

The public half of a key pair. See also key, key pair. 
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A type of cryptography that uses a key pair, with the two keys in the pair called at different 
points in the algorithm. The sender uses the recipient's public key to encrypt the message, and 
the recipient uses the recipient's private key to decrypt it. See also key pair, PKI. 

An arbitrated loop that includes a participating FL_Port and can contain both public and 
private NL_Ports. 

An NL_Port that logs in to the fabric, can function within either a public or a private loop, and 
can communicate with either private or public NL_Ports. 

A type of Fibre Channel controller. 

QuickLoop Fabric Assist. Arbitrated-loop technology. 

Quality of service. 

A group of four adjacent ports that share a common pool of frame buffers. 

A mechanism for each AL_PA address that allows for collecting frames prior to sending them 
to the loop. 

A software product that allows multiple ports on a switch to create a logical loop. Devices 
connected through QuickLoop appear to each other as if they are on the same arbitrated 
loop. 

Allows initiator devices to communicate with private or public devices that are not in the same 
loop. 

Resource allocation timeout value. The maximum time a frame can be delayed in the fabric 
and still be delivered. See also E_D_TOV, RR_TOV. 

Route control. The first 8 bits of the header, which defines the type of frame and its contents. 

Receiver ready. A primitive signal indicating that the port is ready to receive a frame. 

Receiver transmitter timeout value, used by receiver logic to detect loss of synchronization 
between transmitters and receivers. 

The greatest distance between any edge switch and the center of a fabric. A low-radius 
network is better than a high-radius network. 

Redundant array of independent disks. A collection of disk drives that appear as a single 
volume to the server and are fault tolerant through mirroring or parity checking. See also 
JBOD. 

Redundant array of independent tapes. 
Reliable Commit Service. Refers to ILS command code. 
RCS Stage Fabric Config. Refers to ILS command code. 
A device that performs detection and signal processing. 

Having multiple occurrences of a component to maintain high availability (HA). 

An optional product for long-distance fabrics, requiring a Fibre Channel-to-ATM or SONET 
gateway. 

A circuit that uses a recovered clock to regenerate and transmit an outbound signal. 
The rate at which requests arrive at a servicing entity. 

A fabric's ability to adapt to or tolerate a failure of a component within the fabric. 

Two or more switches acting as a core to interconnect multiple edge switches. Nodes attach to 
the edge switches. 

The N_Port with which an exchange originator wants to communicate. 

A circuit that uses an independent clock to generate outbound signals. 

The ratio (expressed in dB) of incident power to reflected power, when a component or 
assembly is introduced into a link or system. Return loss can also refer to optical power or to 
electrical power in a specified frequency range. 

Read Link Status. 
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route 

routing 
RR_TOV 

RSCN 



RTWR 

running disparity 

RW 
RX 

RX_ID 

S_ID 
SAN 

SAN architecture 

SAN port count 
scalability 

SCN 
SCR 

SCSI 

SCSI-2 
SCSI-3 
SDRAM 
sectelnet 
security policy 

SEQJD 

sequence 
sequence initiator 
sequence recipient 

serial 
server 
service rate 



As it applies to a fabric, the communication path between two switches. Might also apply to 
the specific path taken by an individual frame, from source to destination. See also FSPF. 

The assignment of frames to specific switch ports, according to frame destination. 

Resource recovery timeout value. The minimum time a target device in a loop waits after an LIP 
before logging out an SCSI initiator. See also E D TOV, R A TOV. 

Registered state change notification. A switch function that allows notification of fabric 
changes to be sent from the switch to specified nodes. The fabric controller issues RSCN 
requests to N Ports and NL Ports, but only if they have registered to be notified of state 
changes in other N_Ports and NL_Ports. This registration is performed through the State 
Change Registration (SCR) Extended Link Service. An N Port or NL Port can issue an RSCN to 
the fabric controller without having completed SCR with the fabric controller. 

Reliable transport with response. Might appear as a task in portLogDump command output. 

A binary parameter indicating the cumulative disparity (positive or negative) of all previously 
issued transmission characters. 

Read/write. Refers to access rights. 

Receiving frames. 

Responder exchange identifier. A 2-byte field in the frame header that can be used by the 
responder of the exchange to identify frames as being part of a particular exchange. 

Source ID. Refers to the native port address (24-bit address). 

Storage area network. A network of systems and storage devices that communicate using Fibre 
Channel protocols. See also fabric. 

The overall design of a storage network solution, which includes one or more related fabrics, 
each of which has a topology. 

The number of ports available for connection by nodes in the entire SAN. 

One of the properties of a SAN: the size to which a SAN topology can grow port and switch 
counts with ease. 

State change notification. Used for internal state change notifications, not external changes. 
This is the switch logging that the port is online or is an Fx Port, not what is sent from the 
switch to the Nx Ports. 

State change registration. Extended Link Service (ELS) requests the fabric controller to add the 
N Port or NL Port to the list of N Ports and NL Ports registered to receive the Registered State 
Change Notification (RSCN) Extended Link Service. 

Small Computer Systems Interface. A parallel bus architecture and a protocol for transmitting 
large data blocks to a distance of 15 to 25 meters. 

An updated version of the SCSI bus architecture. 

An SCSI standard that defines transmission of SCSI protocol data over different kinds of links. 
The main memory for a switch. 

A protocol similar to Telnet but with encrypted passwords for increased security. 

Rules that determine how security is implemented in a fabric. Security policies can be 
customized through Secure Fabric OS or Fabric Manager. 

Sequence identifier. A 1-byte field in the frame header change to identify the frames as being 
part of a particular exchange sequence between a pair of ports. 

A group of related frames transmitted in the same direction between two N Ports. 

The N_Port that begins a new sequence and transmits frames to another N Port. 

Serializing/deserializing circuitry. A circuit that converts a serial bit stream into parallel 
characters, and vice versa. 

The transmission of data bits in sequential order over a single line. 

A computer that processes end-user applications or requests. 

The rate at which an entity can service requests. See also request rate. 
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SES 

SFF 
SFP 

SFP cable 
SI 

Simple Name Server 
Single Mode 
S-Link Service 

SMDS 

SMF 
SMI 

SNA/SDLC 
SNMP 



SNS 
SOF 

soft zone 



SolP 
SONET 

special character 

SPLD 
SPOF 

SQ_ID 

SRM 
SSH 

Standard Translative 
Mode 

stealth mode 
store-a nd-f orwa rd 



SCSI Enclosure Services. A subset of the SCSI protocol used to monitor temperature, power, 
and fan status for enclosed devices. 

Small-form-factor. An industry term for a smaller transceiver. See also SFP. 
Small-form-factor pluggable. A transceiver used on 2 GB/s switches that replaces the GBIC. 
A cable specifically designed for use with an SFP. Not compatible with GBICs. 
Sequence initiative. 
See SNS. 

The fiber-optic cabling standard for devices up to 10 km apart. 

Facilities used between an N Port and the fabric, or between two N Ports, for login, 
sequence/exchange management, and maintaining connections. 

Switched Multimegabit Data Service. A good protocol for interconnecting LANs; however, 
SMDS has less error-checking capability than Frame Relay. 

Single-mode fiber. See also LWL. 

Structure of management information. A notation for setting or retrieving SNMP management 
variables. 

Systems Network Architecture/Synchronous Data Link Control. A structure for transferring data 
among a variety of computing platforms. 

Simple Network Management Protocol. An Internet management protocol that uses either IP 
for network-level functions and UDP for transport-level functions, or TCP/IP for both. Can be 
made available over other protocols, such as UDP/IP, because it does not rely on the 
underlying communication protocols. See also community (SNMP). 

A switch service that stores names, addresses, and attributes for up to 15 minutes and provides 
them as required to other devices in the fabric. SNS is defined by Fibre Channel standards 
and exists at a well-known address. Also referred to as directory service or name server 

Start of frame. A group of ordered sets that marks the beginning of a frame and indicates the 
class of service the frame will use. 

A zone consisting of zone members that are made visible to each other through client service 
requests. Typically, soft zones contain zone members that are visible to devices using Name 
Server exposure of zone members. The fabric does not enforce a soft zone. Note that 
well-known addresses are implicitly included in every zone. 

SCSI-over-IP. 

Synchronous optical network. A standard for optical networks that provides building blocks 
and flexible payload mappings. 

A 10-bit character that does not have a corresponding 8-bit value but is still considered valid. 
The special character is used to indicate that a particular transmission word is an ordered set. 
This is the only type of character to have five ones or zeroes in a row. 

Simple PLD. Usually, either a PLA or PAL. 

Single point of failure. Any component in a SAN whose malfunction could bring down the 
entire SAN. 

Sequence ID. Used to identify and track all of the frames within a sequence between a source 
(S_ID) and destination (D ID) port pair. 

Storage resource management. The management of disk volumes and file resources. 

Secure shell. Used to support encrypted Telnet sessions to the switch. SSH encrypts all 
messages, including the client sending the password at login. 

Allows public devices to communicate with private devices that are directly connected to the 
fabric. 

A method used in some switches to simulate switches using QuickLoop. 

A switching technique that requires buffering an entire frame before making a routing 
decision. 



298 



striping 
switch 

switch name 

switch port 

switch-to-switch 
authentication 

SWL 

syslog 

T10 

Til 

tachyon 

target 

TC 

TCP/IP 
Telnet 

tenancy 

throughput 

tiering 

Time Server 
topology 



TPC 

track changes 

transceiver 

Translative Mode 

transmission 
character 

transmission word 

trap (SNMP) 

trunking 

trunking group 
trunking ports 



A RAID technique for writing a file to multiple disks on a block-by-block basis, with or without 
parity. 

A fabric device providing bandwidth and high-speed routing of data through link-level 
addressing. 

The arbitrary name assigned to a switch. 

A port on a switch. Switch ports can be E_Ports, F Ports, or FL Ports. 

The process of authenticating both switches in a switch-to-switch connection using digital 
certificates. See also authentication, digital certificate. 

Short wavelength. A type of fiber optic cabling that is based on 850-mm lasers and supports 
1 .0625 GB/s-link speeds. SWL can also refer to the type of GBIC or SFP. See also LWL. 

Syslog daemon. Used to forward error messages. 

A standards committee chartered with creating standards for SCSI. 

A standards committee chartered with creating standards for Fibre Channel. 

A chip that supports FC-0 through FC-2 on a single chip. 

A storage device on a Fibre Channel network. See also initiator. 

Track changes. 

Transmission Control Protocol/Internet Protocol. 

A virtual terminal emulation used with TCP/IP. Telnet is sometimes used as a synonym for the 
Fabric OS CLI. 

The time from when a port wins arbitration in a loop until the same port returns to the 
monitoring state. Also referred to as loop tenancy. 

The rate of data flow achieved within a cable, link, or system. Usually measured in bps (bits 
per second). See also bandwidth. 

The process of grouping particular SAN devices by function and then attaching these devices 
to particular switches or groups of switches based on that function. 

A Fibre Channel service that allows for the management of all timers. 

As it applies to Fibre Channel technology, the configuration of the Fibre Channel network and 
the resulting communication paths allowed. There are three possible topologies: 

• Point to point— A direct link between two communication ports. 

• Switched fabric— Multiple N Ports linked to a switch by F Ports. 

• Arbitrated loop— Multiple NL Ports connected in a loop. 

Third-party copy. A protocol for performing tape backups without using server resources. 

A Fabric OS feature that can be enabled to report specific activities (for example, logins, 
logouts, and configuration task changes). The output from the track-changes feature is dumped 
to the error log for the switch. 

A device that converts one form of signaling to another for transmission and reception; in fiber 
optics, optical to electrical. 

A mode in which private devices can communicate with public devices across the fabric. 
A 1 0-bit character encoded according to the rules of the 8b/l Ob algorithm. 

A group of four transmission characters. 

The message sent by an SNMP agent to inform the SNMP management station of a critical 
error. See also SNMP. 

In Fibre Channel technology, a feature that enables distribution of traffic over the combined 
bandwidth of up to four ISLs between adjacent switches, while preserving in-order delivery. 

A set of up to four trunked ISLs. 

The ports in a set of trunked ISLs. 
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TS 
TTL 

tunneling 
TX 

U_Port 

UDP 
ULP 

ULPJOV 

unicast 

UTC 

WAN 

watchdog 

WDM 

well-known address 

WTV 
WWN 

X.25 
zone 

zone configuration 
zoning 



Time Server. 

Time-to-live. The number of seconds an entry exists in cache before it expires. 

A technique for enabling two netv/orks to communicate v/hen the source and destination hosts 
are both on the same type of netv/ork but are connected by a different type of netv/ork. 

Transmit. 

Universal port. A sv/itch port that can operate as a G_Port, E_Port, F_Port, or FL_Port. A port is 
defined as a U_Port when it is not connected or has not yet assumed a specific function in the 
fabric. 

User Datagram Protocol. A protocol that runs on top of IP and provides port multiplexing for 
upper-level protocols. 

Upper-level protocol. The protocol that runs on top of Fibre Channel. Typical upper-level 
protocols are SCSI, IP, HIPPI, and IPI. 

Upper-level timeout value. The minimum time that an SCSI ULP process waits for SCSI status 
before initiating ULP recovery. 

The transmission of data from a single source to a single destination. See also broadcast, 
multicast. 

Universal Time Conversion. Also known as Coordinated Universal Time, which is an 
international standard of time. UTC is 8 hours behind Pacific Standard Time and 5 hours 
behind Eastern Standard Time. See also GMT. 

Wide area network. 

A software daemon that monitors Fabric OS modules on the kernel. 

Wavelength division multiplexer. Allows multiple wavelengths to be combined or filtered on a 
single cable. 

As it pertains to Fibre Channel technology, a logical address defined by Fibre Channel 
standards as assigned to a specific function and stored on the switch. 

Write timeout value. Refers to an ELS field that appears in portLogDump command output. 

World wide name. An identifier that is unique worldwide. Each entity in a fabric has a 
separate WWN. 

A protocol that uses logical channels. X.25 allows high-quality communications between 
computers and can accommodate no/sy data communications through error-detection and 
error-correction (retransmission) algorithms. 

A set of devices and hosts attached to the same fabric and configured as being in the same 
zone. Devices and hosts within the same zone have access to others in the zone but are not 
visible to any outside the zone. 

A specified set of zones. Enabling a configuration enables all zones in that configuration. See 
also defined zone configuration, enabled zone configuration. 

A feature in fabric switches or hubs that allows segmentation of a node by physical port, 
name, or address. 



300 



Index 



A 

agtCfgSet 1 2 
agtCfgShow 14 
aliAdd 15 
alias 

aliAdd 1 5 

aliCreate 1 6 

aliDelete 1 8 

aliRemove 1 9 

aliShow 20 
aliCreate 16 
aliDelete 1 8 
aliRemove 1 9 
aliShow 20 
ASIC 27, 58 
audience 7 

authorized reseller, HP 9 
B 

banner 

bannerSet 22 

bannerShow 23 
bannerSet 22 
bannerShow 23 
beacon 24 
burn-in 

burninErrShow 25 

burninStatus 26 

diagSetBurnin 63 

diagStopBurnin 65 
burninErrShow 25 
burninStatus 26 

c 

celloPortTest 27 
cfgAdd 30 
cfgClear 3 1 
cfgCreate 32 
cfg Delete 33 
cfgDisable 34 
cfgEnable 35 
cfgRemove 36 
chassisShow 41 
clear 42 
CLI scripts 232 
configDefault 43 
configDownload 44 
configShow 45 
configUpload 46 
configuration parameters 
default values 279-280 



configure 47 
configureZoning 49 
configZoningShow 50 
conventions 

document 8 

text symbols 8 
crossPortTest 5 1 

D 

date 53 

diagDisablePost 55 
diagEnablePost 56 
diagHelp 57 

diagnostic script parameters 64 
diagPortMailbox 58 
diagPortMem 59 
diagPortMemArm 61 
diagPost 62 
diagSetBurnin 63 
diagSetCycle 64 
diagStopBurnin 65 
diagUpload 66 
dIsReset 67 
dIsSet 68 
dIsShow 70 
document 

conventions 8 

related documentation 7 
dynamic load sharing 

dIsReset 67 

dIsSet 68 

dIsShow 70 

E 

E_Port 123, 152, 254 

portCfgEPort 165 
errClear71 
errShow 72 

Ethernet management interface 

ipaddrSet 129 

ipaddrShow 1 31 
event log 

eventClear 75 

eventLogSize 76 

eventShow 79 
eventActionSet 73 
eventActionShow 74 
eventClear 75 
eventLogSize 76 
eventSeverity 77 
eventSeverityShow 78 
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eventShow 79 
events howByN urn 80 
EX_Port99, 104, 108, 110, 146 

portCfgEXPort 1 66 
exit 8 1 

F 

F_Port 258 
fabLogClear 82 
fabLogShow 83 
Fabric Assist 

fazoneCreate 87, 89 

fazoneDelete 9 1 

fazoneRemove 92 

fazoneShow 93 
fabric controller 

fabLogClear 82 

fabLogShow 83 
fabricShow 84 
fan 

fa nS flow 85 

setFanSpeed 223 
fanShow 85 
fastBoot 86 
fazoneAdd 87 
fazoneCreate 89 
fazoneDelete 9 1 
fazoneRemove 92 
fazoneShov/ 93 
FCIP 

fcipShov/ 94 

portCfgFcip 169 
fcipShov/ 94 
fcrConfigure 96 
fcrFabricShov/ 97 
fcrPhyDevShov/ 99 
fcrProxyDevShov/ 1 04 
fcrResourceShov/ 106 
fcrRouteShov/ 1 08 
fcrXlateConfig 1 1 0 

Fibre Channel Shortest Path First, see FSPF 
FSPF 188, 192, 258, 261 

fspfShow 1 1 6 

interfaceShov/ 1 23 

linkCost 1 44 

IsdbShow 148 

nbrStateShow 150 

nbrStatsClear 1 52 
fspfShov/ 1 1 6 

H 

h 1 17 

help 1 1 8 

help, obtaining 9 

history of executed commands 1 17 
HP 

authorized reseller 9 
storage v/eb site 9 
Subscriber's choice web site 9 



technical support 9 

I 

ICMP ECHO_REQUEST 159 
ifcsEnable 1 20 
ifcsShow 1 2 1 
ifModeShow 1 22 
in-order delivery 

iod Reset 1 26 

iodSet 1 27 

iodShow 1 28 
interfaceShow 1 23 
internal port CPU 61 
internal service modules 58 
iod Reset 1 26 
iodSet 1 27 
iodShow 1 28 
IP ping packet 2 1 8 
ipaddrSet 1 29 
ipaddrShow 1 31 

L 

license 

licenseAdd 140 

licenseRemove 141 

licenseShow 142 
licenseAdd 140 
licenseRemove 141 
licenseShow 142 
Link State Database 148 
linkCost 1 44 
LSAN 146 
IsanZoneShow 1 46 
IsdbShow 1 48 

M 

management Ethernet interface 

ifModeShow 1 22 
management interface configuration parameters 280 
management interface parameters 280 
memory subsystem test 61 
MIB-II 12, 14 
MP Router 

Backbone Fabric ID 96 

E_Port 1 08 

EX_Port99, 104, 1 10, 146 
F_Port 1 08 
fcrConfigure 96 
fcrFabricShow 97 
fcrPhyDevShow 99 
fcrProxyDevShow 1 04 
fcrRouteShow 1 08 
IsanZoneShow 146 
NR_Port 108 
portCfgEXPort 1 66 
translate domain 1 1 0 
Multi-protocol Router, see MP Router 
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N 

N_Port 1 55 
Name Server 

nsAIIShow 153 

nsShow 1 55 
NL_Port 155 
NR_Port 108 
nsAIIShow 153 
nsShow 155 

P 

parameters 

management interface 280 
port 280 

system configuration 279 
passwd 1 57 
pdShow 1 58 
RID 65, 99, 104 
ping 159 

port diagnostic error 

portDiagClear 1 79 
port log 

portLogClear 1 86 

portLogDisable 1 87 

portLogDump 1 88 

portLog Enable 1 91 

portLogShow 1 92 
port parameters 280 
port speed 1 75 
port topology 

portCfg Topology 1 77 
portCfgEPort 1 65 
portCfgEXPort 1 66 
portCfgFcip 1 69 
portCfgGige 1 71 
portCfgLongDistance 173 
portCfgSpeed 1 75 
portCfg Topology 1 77 
portDiagClear 1 79 
portDiagDisable 1 80 
portDiagEnable 1 8 1 
portDisable 182 
portEnable 1 83 
portLogClear 1 86 
portLogDisable 1 87 
portLogDump 1 88 
portLog Enable 191 
portLogShow 1 92 
portName 1 97 
portPerfShow 198 
portRoutelnfo 200 
ports how 201 
portStart 205 
portStatsShow 206 
portStop 207 
portType 208 

POST, see power-on self-test 
power supply 



psShow 21 5 
power-on self-test 

diagDisablePost 55 

diagEnablePost 56 

diagPost 62 

fastBoot 86 
ps 209 
psShow 215 

Q 

quit 216 

R 

rack stability, warning 8 
reboot 2 1 7 

recovery kernel version 
showRecovery 229 

related documentation 7 

rnPing 21 8 

route configuration 
routeShow 2 1 9 

routeShow 2 1 9 

s 

scripts 232 

security banner, see banner 
setFanSpeed 223 
setPagerOff 224 
setPagerOn 225 
SEP 

sfpShow 226 

sfpSupport 228 
sfpShow 226 
sfpSupport 228 
showRecovery 229 
SNMP 

agtCfgSet 1 2 

agtCfgShow 14 
spinSilk 230 
static route 

urouteConfig 258 

urouteRemove 260 

urouteShow 261 
Subscriber's choice, HP 9 
supportShow 232 
svipAddrSet 233 
svipAddrShow 234 
switchDisable 235 
switchEnable 236 
switchName 237 
switchShow 238 
switchStatusShow 241 
symbols in text 8 
syslog 

syslogdipAdd 242 

syslogdipRemove 243 

syslogdipShow 244 
syslogdipAdd 242 
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syslogdipRemove 243 
syslogdipShow 244 
system configuration parameters 279 
system parameters 279 

T 

technical support, HP 9 
temperature sensor 

tempShow 245 
tempShow 245 
text symbols 8 
time zone 

timeZoneSet 247 
timeout 246 
timeZoneSet 247 
top 248 

topologyShow 25 1 
trunking 

trunkReset 253 

trunkSet 254 

trunkShow 255 
trunkReset 253 
trunkSet 254 
trunkShow 255 
tsclockserver 256 

u 

unicast fabric topology 

topologyShow 25 1 
upTime 257 
urouteConfig 258 
urouteRemove 260 
urouteShow 261 
userAdd 263 
userDel 264 
users 265 
userShow 266 

V 

version 267 

virtual management IP 

svipAddrSet 233 

svipAddrShow 234 

w 

warning 

rack stability 8 
wdogevt 268 
web sites 

HP storage 9 

HP Subscriber's choice 9 

z 

zone configuration 
cfgAdd 30 
cfgClear 3 1 
cfgCreate 32 
cfg Delete 33 



cfgDisable 34 

cfg Enable 35 

cfgRemove 36 

cfgSave 37 

cfgShow 38 

configureZoning 49 

configZoningShow 50 
zoneAdd 269 
zoneCreate 270 
zoneDelete 272 
zoneRemove 273 
zoneShow 274 
zoning 

aliShow 20 

zoneAdd 269 

zoneCreate 270 

zoneDelete 272 

zoneRemove 273 

zoneShow 274 
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